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PREFACE 


This reference publication is intended for programmers using the MRX/OS Assembler 
Language. This publication describes how to write assembler source statements, including 
assembler instructions, macro instructions, and conditional assembly statements. These | 
instructions are summarized in Appendix E. Machine instructions and extended mnemonic 
codes are summarized in Section 3, and additional reference tables appear in Appendixes B, 
C, and D. The machine instructions are described in detail in the publication 7200 or 7300 
Processing Unit Reference. 
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l. INTRODUCTION 


FUNCTION OF THE ASSEMBLER 


The MRX/OS Assembler consists of a language and an assembler program. The language is a 
set of codes and coding rules for writing a source program. The assembler program translates 
the source program into an object program that can be executed by the system. The object 
program produced by the assembler is in the form of relocatable object modules. This 
translation process is called an assembly. | 


Two types of source statements can be expressed in the assembler language, machine 
instructions and assembler instructions. 


The machine instruction source statements provide mnemonic codes for all machine 
instructions in the MRX 40/50 instruction set. Extended mnemonic codes are also provided 
for the skip and branch instructions. Section 3 of this manual describes the general format 
of the machine instructions. A complete description of the machine instructions, addressing 
techniques, and data representation is in the manual 7200 or 7300 Processing Unit 
Reference. 


The assembler tnstruction source statements specify auxiliary functions to be performed by 
the assembler program. These functions include: 


® Checking and documenting programs 

e Controlling address assignment 

® Segmenting programs 

e Defining data and symbols 

@ Generating macro and form instructions 

e Controlling the assembly process through conditional assembly 
statements 


The macro facility enables the programmer to define and use macro instructions. A macro 
instruction is represented by an operation code which, in turn, stands for a sequence of 
statements that accomplish the desired function. 


Conditional assembly statements affect the order of source statement assembly and macro 
generation, or the content of generated statements. 
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A listing of the source program statements and the resulting object program statements may 
be produced with programmer control of form and content. A cross-reference list of symbol 
definitions and references is also produced unless suppressed by the programmer. Errors 
detected during assembly are indicated in the program listing. Warning errors may be 
suppressed. . 


RELATIONSHIP TO THE OPERATING SYSTEM 


The assembler program is a component of the MRX 40/50 operating system and operates 
under its control. The operating system provides the assembler program with input/output, 
segment loading, library, and other services needed for its proper functioning. The assembler 
program is called through Control Language statements and resides in a user partition during 
execution. 

W 


SYSTEM REQUIREMENTS 


The MRX 40/50 System equipment configuration required to execute the assembler 
program is as follows. 


e 16K bytes of main storage, of which at least 8K bytes must be 
available to the assembler (additional storage, up to 24K, will 
increase the performance of the assembler) 


e One source input device or data set 
e One list device or data set 

e One operator console 

@ One 660 disc storage drive 

e The standard instruction set 
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2. WRITING SOURCE STATEMENTS 


To write source statements, the programmer should be familiar with the following topics: 


e Character set 
e Basic format of source statements 
e Types of terms and expressions 
8 Coding form 
CHARACTER SET 


Source statements may contain the following characters: 


Letters A through Z, and $ 


Digits 0 through 9 


Special 
Characters 


The EBCDIC formats and card punch codes for these characters are listed in Appendix A. 
Any of the 256 punch combinations may appear inside a character constant, in comments, 
or in macro instruction operands. The meanings of these characters, and combinations of 
these characters, are explained in Figure 2-1. | 
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Character 


A through Z, and $ 
0 through 9 


Explanation 


Used in symbols and character string constants 


Used in numeric constants and symbols 


Operand or suboperand separator 


Defines a character constant (all characters to 
the next apostrophe) 


Defines a hexadecimal string constant (all hexa- 
decimal characters to the next apostrophe) 


Defines a packed decimal string constant (all 
characters to the next apostrophe) 


Defines a. zoned decimal string constant (all 
characters to the next apostrophe) 


Defines an intoger string constant (all 
characters to the next apostrophe) 


Defines a floating point string constant (all 
characters to the next apostrophe) 


Defines a hexadecimal. arithmetic constant 


Define relational (EQ, GT, LT, NE, LE, GE) 
and logical (NOT, AND, OR, EOR) operations 


Defines a reference to a symbol length attribute 


Location counter reference or multiplication 
indicator 


Division indicator (Note that 1/2=0 because 
division always results in an integer, not a 
fraction.) . 


Addition indicator 


Subtraction indicator 


Defines a variable symbol! 


Separates an address-modifying index from the 
rest of the address, delimits sublisted operands, 
or encloses operands or suboperands 


Used for sequence symbols and concatenation 


Used for macro definition comments 


The character following this symbol is to be 
evaluated for its literal value, not for its special 
function. In the example, the symbol following 
the #- sign is a semicolon, not a continuation 
indicator. 


Continuation Indicator 


indirect addressing 


Field separator 


Figure 2-1. Character Usage 
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Indicates a literal term or a keyword parameter value 


Example 


C’ACCOUNT NO.’ 
TAG3,5825 
HERE, THERE 
=A+2 

C’ABC’ 


X’1AFEE’ 
P’425' 

2’-44' 
V'4286' 
D’147 .25E-1’ 


“FEFIA 


A<EQ>B 
A<AND>B 


L’SYMX 


#44 
12*20 


10/0 
TAG/B 


TAG+12 
TAB-4 
&TAC 
PAG(R2) 


.LAST 
.*COMMENT 
c'24 44 


THE STATEMENT IS; 
@REG1,@TAG1 
ADDR 3,4 


BASIC FORMAT OF SOURCE STATEMENTS 


Source program statements have the fields outlined in Figure 2-2. 


Name Operation 
Any symbol | Machine instruction, Single expression, Informational material 
or blank assembler instruction, | several expressions, | or blank 


macro instruction, or or blank 


FORM instruction 


Figure 2-2, Source Statement Format 


The name field entry is a symbol used to identify a statement. The name field is necessary 
for certain statements, or when the statement is referred to in another statement, such as in 
a Branch instruction. 


The operation field entry is a predefined mnemonic code (or mnemonic) which identifies 
the function of a machine, macro, assembler, or FORM instruction. Mnemonics are designed 
to be easily learned and remembered; for example, ADDR for Add Register-Register, or 
EQU for an Equate assembler instruction. 


The operand field entry defines or identifies the data involved in the operation. Most 
statements have one or more operands, although some statements have no operands at all. 
Each operand has one or more terms, which may be used in a combination to form one or 
more expressions. (Refer to immediately following text for a discussion of terms and 
expressions.) An operand field may not have more than 35 terms. Operands of machine 
statements generally represent storage locations, general registers, immediate data, or 
constant values. Operands of assembler statements provide the information necessary for the 
assembler to perform the designated operation. 


The optional comment field contains any informational material the programmer wishes to 
add. 

TERMS AND EXPRESSIONS 

A term is a symbol, character, or number that represents a value; an expression is a single 


term or a combination of terms. An expression is used in the operand field of a source 
statement. The following text fully defines terms and expressions. 
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TERMS 


Every term represents a value; the value may be assigned by the assembler program (symbol, 
symbol length attribute, location counter reference) or may be inherent in the term itself 
~ (constant, literal). 


An arithmetic combination of terms is reduced to a single arithmetic value by the assembler. 
An arithmetic value is represented as a 16-bit binary value in two’s complement form. A 
logical value has a range of 0 through 65,535; and an arithmetic value has a range of -32,768 
through 32,767. Limitations on the value of an expression depend on its use. For example, a 
term designating a general register must have a value between 0-7 inclusively; a term 
representing an address must not exceed the size of storage. 


A term is absolute if its value does not change upon program relocation. It is relocatable if 
its value changes upon program relocation. 


The terms used in assembler statements are outlined in Figure 2-3. An explanation of each 
type of term and the rules for its use are provided in the following text. 


Character String 
Constant C'ABC' 


Hexadecimal String 
Constant X'C49FE’ 


Packed Decimal 


Stri ng Constants String Constant P’-244’ 


Zoned Decimal 
String Constant Z'246' 


Integer String 
Constants Constant 1-323’ 


Floating Point 


String Constant D’146.3E-1' 
P : Decimal Arithmetic 
ARtnnetle Constant 2316 
Constants 


Hexadecimal! Arithmetic 


Constant “Q2FA 
Ordinary Symbols 
Symbolic Parameter &TAB1 
Symbols Variable Symbols System Variable Symbols &SYSNDX 
Set Symbols &TABS 
Sequence Symbols 
Location 
Counter 
Reference *.20 
Symbol 
Length 
Attribute L’TAB1 
Literals =HERE 


Figure 2-3. Types of Terms 
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CONSTANTS 


Constants are terms whose values are inherent in the terms themselves. They specify 
machine values or bit configurations directly, rather than by equating the values to symbols 
and then using symbolic references. Constants represent such program elements as 
immediate data, masks, registers, addresses, and address increments. 


Constants are string or arithmetic. String constants are of variable size; arithmetic constants 
are 16 bits long. Examples of all types of constants are presented in Figure 2-6. 


String Constants 


A string constant can only be used as a single term expression, or in a relational expression. 
In a relational expression, both terms must be of the same type (character, hexadecimal, 
etc.), for example: C‘ABCE’< LT >C’&P1’. 


Character String Constant 


A character string constant is written as the letter C followed by a character string enclosed 
in apostrophes, for example: C’STRING’. To represent the literal value of an apostrophe, an 
ampersand, a semicolon, or a pound sign as part of the character constant, the character 
must be immediately preceded by an escape character, which is the pound sign. The length 
of a character constant is equal to the number of characters in the constant, excluding the 
escape characters, which do not appear in storage. 


Examples of character constants are shown in Figure 2-4. In the last example of Figure 2-4, 
the generated code is: THIS STRING HAS MANY SPECIAL CHARS IN IT: # ;’ &. 


QPERAND 


| 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 at 42 43 44 45 46 47 48 49 50 51 52 63 54 56 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 Ns 
. cs cee ers se heen ob orenowenbneisttredarnwacwony. ere Alero ecw —ttn ae ne nan henchenenrenlnswhinammreln meena aeicacrteine remnant nme nnnabiee etalon vane dannselhceaa irae talk omesrcnter enshersmelin ss de 


enfant 


C' THIS TS A. MESSAGE’ 
~ aOR a 2 ntl -5 Whoo ReneS Sete! ORE Geeta Ce URE Lane SES GENS! Coy lareen SSS ewteess Easy Uke USERS Ueycea! Cees Week! (Cay Tames Spin SMe! Me LAr MCT MOST CaS RRS LAUR CREO (ROSE IEE 


an Eka pares cae PY ree! Neeey Renny Entaris Cormeen Gen Mecmeney Ceneers) Gani WORSE weer 1 fees Genees gene Weems Ceoneed aed) Ete Unread Croan CMe Cees eee IRGC ReenOeY (ON) eRe Keel (a 


C'TNIS. CHARACTER STRING. . Bye NAS etree els tee te mes etal a 
! G ‘ NTLNUVE DD! _ pi Rete, Veer eproh APO ROS SAUTE CODON SIA SiON HEMEra | dis, i Rint hs 5 Bea Be Bee Re SR SBS ak BR CARTER LON SAM IMIR Kee aN! SER Sagem NG Me MCN Pie! RENO Garene Rea) Cree” oly 
C'TNLS CHARACTER STRING#SIS NOT. SONTII NVED.’. Paces 


C’ TALIS. STRING HAS. MANY. SPECZAL_CHARS | IN sera ae 


el a $e = oh. Senne nee a ee ee One Cae a a Ss ae Cs Sane Be SA | Mok be dk 


ae CO YOY CS OR SSI SEE EN SOR GO SNS SOS) SRN COON SOE, SOS COO. URNS CS SO SEY nO SENT MOONS SECS SO Coa SSeS OOO SE SO SN eS SOE ORR SORES SER OSE SEUSS COS, CONSOON WORSEN” GOREON GONE CDSN USNOS SOIEES HOnennr Cunneay Cunnnn, Rainn 


el ll a len ee Me ep lhe ells edt ee ela er fe le al af eM Nl A Mc th et lh 


Pare ne NY CY Once a Cs SO SS OBOE ORES OP EES ee eee! ee! tc eee OOO Cee SE A fA... bb, 4 AL. men ieee eee Raven! Cope Cnepeny Waeees Eire | [a ieee Sone ong see eee One ne Bd 


Figure 2-4, Character Constants 
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If the following characters are not preceded by an escape character in a character constant, 
they have the meaning given below: 


Character Meaning 


A character constant is continued on the next line 
tog Encloses the characters of a character constant 
Variable symbol 


# Next character retains its literal value 


Hexadecimal String Constant 


A hexadecimal string constant is written as the letter X followed by a string of hexadecimal 
digits enclosed in apostrophes, such as: X‘C49FE’. Each hexadecimal digit is translated into 
its four-bit equivalent. The maximum size of a hexadecimal! string constant is limited to the 
maximum number of digits that can be contained on two coding lines. !f an odd number of 
digits is specified, the leftmost four bits in the leftmost byte are set to zero. The implied 
length of the constant is half the number of hexadecimal digits in the constant, rounded to 
the next higher integer. 


Packed Decimal String Constant 


A packed decimal string constant is written as the letter P followed by a signed integer 
number enclosed in apostrophes, such as: P’-244’. If the sign is omitted, the number is 
assumed to be positive..Each pair of decimal digits is translated into one byte. The rightmost 
byte of a packed field contains the rightmost digit and the sign. Signs generated are ‘‘C16” 
for plus, and "D716" for minus. The maximum length of a packed decimal string constant is 
limited to the number of digits that can be contained on two coding lines. 


Zoned Decimal String Constant 


A zoned decimal string constant is written as the letter Z followed by a signed integer 
number enclosed in apostrophes, for example: Z2‘246’. If the sign is omitted, the number is 
assumed to be positive. Each decimal digit is translated into one byte. The rightmost byte 
contains the sign and the rightmost digit. Signs generated are “C16” for plus, and “D716” for 
minus. The maximum length of a zoned decimal string constant is limited to the number of 
digits that can be contained on two coding lines. 


Integer String Constant 


An integer string constant is written as the letter | followed by a signed integer number 
enclosed in apostrophes, such as: |’-246’. If the sign is omitted, the number is assumed to be 
positive. An integer string constant is translated into its four-byte binary equivalent. Integer 
constants consist of 1-10 digits with a value ranging from -231 to 231-1. The constant is 
word aligned when used in a WDD statement or a literal. 
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Floating Point String Constant 


A floating point string constant is written as the letter D followed by a floating point 
number enclosed in apostrophes, such as: D’+2.461E-1’. The number is written as a signed 
or unsigned decimal value; if the sign is omitted, the number is assumed to be positive. The 
decimal point may appear before, within, or after the number, or it may be omitted. The 
exponent is optional. it is written immediately after the number in the form Enn, where nn 
is a signed or unsigned decimal! integer specifying the exponent of the factor 10. If the 
exponent is unsigned, a plus sign is assumed. 


Alignment can be specified by all data definition statements (WDD, BDD, and FORM). Byte 
alignment is allowed to facilitate building tables containing mixed values with odd 
bounding. Note, however, that all floating point instructions require word bounding of the 
operand in storage. The optional size and repetition factors may be coded. 


The implicit length of a floating point constant is eight bytes, and it is carried as such 
through the assembly. Truncation or padding occurs at object output time with no 
rounding. The floating point decimal value may contain a maximum of 152 digits (including 
the exponent) in addition to the decimal poe and sign. The approximate decimal range of 
values allowed is 7.2 X 1075 to 5.4 X 10°79, 


The internal format of floating point numbers is described in the 7300 Processing Unit 
Reference manual. 
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When string constants define data in storage, truncation and padding of their values is 
performed according to the rules presented in Figure 2-5. 


Explicit Length= 


Explicit Length > 


Explicit Length< 


Constant Implicit Length Implicit Length Implicit Length 
Character C’ABC’(3)=ABC Left justify. Loft justify, 
Biank fill on right. Truncate on right. 
C’ABC’ Warning message is given. 
C’ABC’ (4)=ABC 
C’ABC'(2)=AB 
Hexadecimal Right justify. Right justify. Right justify. 
Zero fill on left if the Zero fiil on left. Truncate on left. 
X’10A’ constant contains an Warning message is given. 
odd number of digits. X’10A’(3)=00010A 
| X’10A'(1)=0A 
X’10A'(2)=010A 
Packed Right justify. Right justify. Right justify. 
Decimal Zero fill on left if the Zero fill on left. Truncate on left. 
constant contains even Warning message is given. 
P’-24' number of digits. P’-24’(3)=00024D 
P’-24'(1)=4D 
P’-24’ (2)=024D 
Zoned 2'123'(3)=F1F2C3 Right justify. Right justify. 
Decimal : Zero fill on left. Truncate on left. 
Warning message is given. 
2123’ 2'123' (4)=FOF1F2C3 
. F'123'(2)=F2C3 
Integer Right justify. Right justify. Right justify. 
Propagate sign on left. Propagate sign on left Truncate on left. 
i’-758’ | Sign is lost. 
’-758' (4)=FFFFFDOA \'-758' (6)= Warning message is given. 
FFFFFFFFFDOA 
1’-758'(1)=0A 
Floating Normalize Expand fraction. Truncate fractional 
Point Size = 8 bytes Zero fill on right. Position on right, no 
| rounding. 
Warning message is given. 
D’+1.3’ D’+1.3’= D’+1.3(10)= 
4114CCCCCCCCCCCD 4114CCCCCCCCCCCDO0N00N | p’+1 .3(4)=4114CCCC 


Figure 2-5. Truncation and Padding of String Constant Values 


Arithmetic Constants 


Arithmetic constants can be used in multi-term expressions. An arithmetic constant is 
assembled as its two-byte binary equivalent. The maximum size of an arithmetic constant is 
216.1, If arithmetic constants are used in statements where an explicit size is specified, 
truncation and padding follow the same rules as those for an integer string constant. 


Decimal Arithmetic Constant 


A decimal arithmetic constant is written as an unsigned integer number of 1-5 digits, for 
‘example: 20. 
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Hexadecimal Arithmetic Constant 
A hexadecimal arithmetic constant is written as quotation marks followed by a string of 1-4 


hexadecimal digits, for example: ‘““2FA. Each hexadecimal digit is assembled as its four-bit 
binary equivalent. 


Type Example Generated Hexadecimal Code 
Character String C’F1I2AY9*’ C6F1IF2C1E8F95C 
csz4 tHe: 5BE97D7BF5 
C’B’ Cc2 
Hexadecimal String X’C49 FE’ OC49FE 
X’F2’ F2 
x'C’ oc 
Packed Decimal String P’14’ 014C 
P’925860' 0925860C 
P’-2" 2D 
P’-2596’ 02596D 
Zoned Decimal String 2714’ F1C4 
2'925860' FOF2ZF5FS8F6CO 
Z’-2’ D2 
2’ -2596" F2F5F9D6 
integer String 14° 00 00 00 OE 
1925860’ 00 OE 20 A4 
'-2’ FF FF FF FF 
‘’-2596’ FF FF FS DC 
Floating Point String p10" 41 A000 00 00 00 00 00 
D’+99999999’ 49 25 40 BE 3F FO 00 00 
D’-50.25E-1' C150 66 66 66 66 66 66 
Decimal Arithmetic 14 OOO0E 
302 012E 
57399 E037 
Hexadecimal Arithmetic "44 0014 
“F2A OF2A 
“EOOF EOSF 


Figure 2-6, Examples of Assembled Constants 


SYMBOLS 


A symbol is a character or combination of characters used to represent locations or arbitrary 
values. Symbols, through their use in name fields and operands, provide the programmer 
with an efficient way to name and reference a program element. A symbol is defined when 
it appears in the name field of a source statement. 
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In general, symbols must conform to these rules: 
1. The symbol must not have more than eight characters. 


2. The first character must be a letter, a period, a dollar sign, or an 
ampersand (&). 


3. The remaining characters may be digits, letters, or dollar signs. If the 
first character is a period or an ampersand, the second character must 
be a letter or a dollar sign. 


4. The first blank after the start of asymbol terminates that symbol. 
5. Symbol definitions cannot be continued. 


The assembler has three types of symbols: ordinary symbols, variable symbols, and sequence 
symbols. Sequence symbols and variable symbols are used only for the macro language and 
for conditional assembly. 


Ordinary Symbols 


An ordinary symbol consists of 1-8 alphanumeric characters, the first of which must be a 
letter or a dollar sign. Ordinary symbols identify program locations or arbitrary values. The 
value of an ordinary symbol may be absolute or relocatable. Examples of ordinary symbols 
are: 


BETA 
X242 


SENTRYP1 


An ordinary symbol that names an instruction, a storage area, a data definition, or a control 
section is the address of the leftmost byte of the identified field. Address values are 
relocatable terms. The value of an address symbol must not exceed 216-1. 


An ordinary symbol may be defined only once in an assembly. That is, each symbol used as 
the name of a statement must be unique within that assembly. However, a symbol may be 
used more than once in the name field of a COM or CSECT assembler statement, because 
the coding of a control section may be suspended and then resumed at a subsequent point. 
Some statements require that a symbol in the operand field be previously defined. 


During assembly, the assembler assigns a length attribute to all ordinary symbols. The length 
attribute of a symbol is the length, in bytes, of the storage field whose address is represented 
by the symbol. For example, a symbol naming an instruction that occupies four bytes of 
storage has a length attribute of four. 
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Variable Symbols 


A variable symbol is a symbol that is assigned different values by the programmer or the 
assembler. The three types of variable symbols are: 


1. Symbolic parameters — used only in macro definitions; values are 
assigned by macro instructions. 


2. System variable symbols — used only in macro definitions; values are 
assigned by the assembler. 


<3 Set Symbols — used anywhere in the source program; values are 
assigned by SET or GBL statements. 


Variable symbols consist of an ampersand (&) followed by one to seven alphanumeric 
characters, the first of which must bea letter or a dollar sign. Examples of variable symbols 
are: 


&BETA 
&X24 


&P 1 


Concatenation of Variable Symbols 


When a variable symbol is assembled, the current value assigned to the variable symbol is 
substituted for the variable symbol. If a variable symbol is immediately preceded or 
followed by other characters or by another variable symbol, concatenation of the variable 
symbol with another variable symbol or character occurs. To concatenate a variable symbol 
with a letter, digit, period, or left parenthesis that follows the symbol, a period must 
immediately follow the variable symbol, for example: &VAL.8. The period merely indicates 
the end of the variable symbol and does not appear in the generated code. The size of a 
concatenated symbol is limited only by the maximum statement size. However, the 
generated symbol is limited by the rules which pertain to the generated name, operation, or 
operand field. See Figure 2-7 for examples of the concatenation of variable symbols. 


Assume that the following values have been assigned to these variable symbols: 


&P1 = ROP 
&P2 = 5 
&P3 = @ 

Initial Code Generated Code 
&P1&P2 ROPS 
&P1.8 ROP8 
&P3.R7 @R7 
B.&P2 B.5 
&P1 ROP 
703&P2 7035 


-F igure 2-7. Concatenation of Variable Symbols 
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Sequence Symbols 


Sequence symbols consist of a period followed by one to seven alphanumeric characters, the 
first of which must be a letter or a dollar sign. Sequence symbols can be used in the name 
field of any statement except MACRO, GBLA, and GBLC, and in the operand field of only 
ADO or AGO statements. The programmer can use sequence symbols to vary the sequence 
in which statements are processed by the assembler. Examples of sequence symbols are: 


.LAST 
“HERE 


LOCATION COUNTER REFERENCE 


A location counter assigns storage addresses to program statements. It is the assembler’s 
equivalent of the instruction counter in the computer. As each machine instruction or data 
area is assembled, the location counter is first adjusted to the proper boundary for the item 
(if adjustment is necessary) and then incremented by the length of the assembled item. 
Thus, it always points to the next available location. If the statement is named by a symbol, 
the value of the symbol is the value of the location counter before addition of the length. 


The assembler maintains a location counter for each control section of the program and 
manipulates each location counter as previously described. Source statements for each 
section are assigned addresses from the location counter for that section. The location 
counter for a given control section assigns locations in storage without regard to assignments 
made within other control sections. 


Thus, if a program has multiple control sections, all statements identified as belonging to the 
first control section will be assigned from the location counter for section 1; the statements 
for the second control section will be assigned from the location counter for section 2, etc. 
This procedure is followed whether the statements from different control sections are 
interspersed or written in control section sequence. 


The location counter setting is controlled by using the ORG and ALIGN assembler 
statements. The counter affected by an ORG statement is the counter for the control 
section in which it appears. The maximum value for the location counter is 216-1. 


The programmer can refer to the current location counter by using an asterisk in the 
operand field. The asterisk represents the value of the current location counter at the start 
of the current statement. This value is relocatable. 


An example of the use of the location counter is: 


OPERATION 


NAME OPERAND 


ee ae ae ee ae 


10 11 12 13 14 15 16 17 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 
i ee. Ce oe 


If the location counter is at 0100 when this statement is encountered, the following data is 
generated: 


Location Value 
0100 0100 
0102 0100 
0104 0100 


SYMBOL LENGTH ATTRIBUTE 


The length attribute of a symbol may be used as a term by writing L’ followed by the 
symbol, for example: L’SYMX. The length attribute of SYMX is then substituted for the 
term. The length attribute of an ordinary symbol is the length, in bytes, of the storage field 
whose address is represented by the symbol. 


The length attribute of * is invalid. If the operand of an EQU statement is an asterisk or an 
arithmetic constant, the symbol defined by the EQU statement has a length attribute of 
one. In any other context, the length attribute of an arithmetic constant is two. Examples 
of symbol length attributes are shown in Figure 2-8. 


12,34 5 6 7 8{9] 10 11 1213 14 15 16 {yoo 
A nk DD. { oxsr: erie ore 
_L' NUM® CARITH ONSTANT). Se ee et 
NUM | IEqu. S6*10 ek a es at pa ean 
Le NUMI T CARITH CONSTANT IN Eau STATEMENT). .W... 
NST. eee eid ene a 
« L! INST 4 “chop. iStRUCTION 1 Is 4 BYTES LONG). Tae: 
Loc . FQu |. a re ea ECAR 
¥ L'Locelt| CLOCATION CTR REE IN ‘Eau STATEMENT). . 
CONS FQU..._| C.' THLS STRING. eee 
L" CONS Ll. CBLEV N CHARACTERS. . are “STRING) ....._... 


onan ee 2 Pogo tare ath delice GcbemctyeeA) oby » ean a Comer ak ao te a a a a a tt 


DD. | rte" oe 
AL INT+H™ CENT STRING. ‘Is HM BYTES LONG), 


an ane tn ane ene eee meee LONrre! GES Coens Une Cn? veceny Sceece Coney sei (ee f— 4a a MO Ma Ml 5 ll ce rill, 


Figure 2-8. Examples of Length Attributes 
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Bulletin: 2202.001-0101 
Date: 3/19/73 


LITERALS 


~ A literal term is used to introduce data into a program. The formats of a literal term are as 


follows. 
Where: 


=Q a is the data value to be generated (required); any legal expression 
except another literal term. 


=a(b,c) b _ is the length specification (in bytes): a positive absolute expres- 
sion. If omitted, the length specification is the implied size of 

=a(b) the expression. 

c _ is the repetition factor; a positive absolute expression. If omitted, 


a repetition of 1 is assumed. If the size or length is specified 
symbolically, the symbol must have been previously defined. 


Examples of literals are shown in Figure 2-9. 


==C’ABD' Invalid: literal cannot define another literal. 
=C’ABD'(4,3) Valid: same as =C’ABD ABD ABD’ 
=A+B/2+4 Valid: implied length is the length of symbol A; implied 


repetition factor is 1. 
=P’.446'(6) Valid: specified length is 6; implied repetition factor is 1. 


=X‘FFOO'(,3) Valid: implied length is 2; specified repetition factor is 3. 


Figure 2-9. Examples of Literals 


The assembler generates the literal data, stores this data in a literal pool, and places the 
address of the stored data in the operand field of the statement using the literal. The 
position of the literal pool may be controlled by the programmer with the LTORG 
assembler statement. If LTORG is not specified at the end of a control section, the literal 
pool for that segment is placed at the end of the first control section. 


A literal can be defined at any point in a program by specifying the literal in the operand of 
the statement in which it is used. In contrast, data definition statements define and label 
data, and then the label is used to specify the data. 


A literal may not be combined with any other term, nor may a literal be used as a receiving 
field of a statement that modifies storage. . 


Literals are relocatable, because the address of the literal, not the literal itself, is assembled 
into the statement using the literal. 
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lf duplicate literals are specified within one literal pool, only one literal is stored. Literals 
_ are duplicate if their final specifications, size, and repetition factors are identical on a 
character-by-character basis. A literal may be a duplicate even when it appears to be 
different (see examples in Figure 2-10). A literal is a duplicate if it contains no forward 
references and the expressions evaluate to the same value as the corresponding expressions 
of an existing literal. 


A literal which contains a reference to the location counter is stored even if it duplicates 


another literal (see examples). If an expression used in a literal term contains a forward 
reference to a symbol, the symbol is assumed to represent a two-byte value. 


Examples of duplicate literals are shown in Figure 2-10. 


=C'ABC'(4,3) Only one literal is stored. 

=C’ABC'(4,3) 

=C’ABC’ Both literals are stored. 

=X'C1C2C3’ 

=A+B Only one literal is stored if A and B are predefined symbols. 

=B+A 

=C<EQ>D Only one literal is stored if C is defined to be equal to D, so that the 
=1 expression is equal to 1. 

=*+10 Both literals are stored 

=*+10 


Figure 2-10. Examples of Duplicate Literals 


EXPRESSIONS 


An expression is defined as one or more terms linked by arithmetic, relational, or logical 
operators. Expressions may be single term or multi-term (see examples below). 


Single Term Expressions Multi-Term Expressions 

29 SYMX+40 

“FO A+B/2+10 

SYMX (X<OR >"‘FOFO)< EQ >(SP2<OR >“FOFO) 
* (((A+4)/2+1)*2< AND >"00FF) <EQ >24) 
L’'SYMX » *+L'BETA 

P’-240' A+B<LE>SUM 
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During assembly, all expressions are resolved to a single value. Figure 2-11 provides an 
explanation of all types of operators. : 


The rules for coding expressions within an operand field are as follows. 

1. An expression may not start with an arithmetic, relational, or logical 
operator. However, an expression may begin with a unary operator: 
positive sign (+), negative sign (-), or logical complement (< NOT >). 
A unary operator indicates the state of the numbers it precedes (such 
as negative, positive, or complement), rather than indicating an 
arithmetic operation (such as addition or subtraction). 


2. An expression may not contain two terms in succession. 


3. An expression may not contain two operators in succession, except 
for the logical operator <NOT>, which may follow the logical 
operators <AND>, <OR>,and <EOR>. 


4. A multi-term expression may not contain a literal. 


5. In a multi-term expression, string constants are restricted to 
relational operations. 


EVALUATION OF EXPRESSIONS 

A single term expression has the value of the term involved. 

A multi-term expression is reduced to a single arithmetic value as follows. 
1. Each term is given its value. 


2. Operations are performed from left to right using the following rules 
of precedence: 


a. Unary arithmetic operations: positive (+) and negative (-). 

b. Arithmetic multiplication (*) and division (/). 

c. Arithmetic addition (+) and subtraction (-). 

d. Relational operations (<EQ>, <NE>, <LT>, <GT>, 


<LE>,and <GE>). 


e. Unary logical complement (<NOT>). 
f. Logical product (<AND>). 
g. Logical addition (<OR>) and subtraction (< EOR >). 
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3: The expression is computed to 32 bits, and then truncated to 16 bits 
or less, depending on its contextual use. 


4. Division always yields an integer result. For example, 1/2*10 yields a 
zero result, whereas 10*1/2 yields 5. Division by zero is permitted 
and yields a zero result. 


5. A relational operation yields a binary result of O or 1. If string 
constants are used in relational operations, both relational terms 
must be of the same type; thus, P’246’<EQ>2Z’246’ is illegal. 


6. Logical operations are performed on a bit-by-bit basis equivalent to a 
masking operation. A non-zero value is considered true and a zero 


value is considered false. 


Arithmetic Operators 


Figure 2-11. Types of Operators 
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Operator Meaning Example 

+ Addition A+B 
Subtraction 10-C 

* Multiplication D*16 

/ Division 25/X 

Relational Operators 
- Operator —. Meaning Example 

<EQ> Equal to A<EQ>B 

<NE> Not equal to A<NE>B 

<LT> Less than 17<LT>&P1 

<GT> Greater than 69<GT>TAB 

<LE> Less than or equal to 73<LE>M 

<GE> Greater than or equal to "3F<GE>&TAB1 

Logical Operators 

Operator _ Meaning Example 

<NOT> Logical complement (one's <NOT>A 
complement) 
Logical product A<AND>B 
Logical addition (inclusive or) A<OR>B 
Logical subtraction (exclusive or) A<EOR>W 


Parentheses are used in the normal role of arithmetic grouping to change the order of 
evaluation. Parenthesized parts of an expression are evaluated before the rest of the terms in 
the expression. In the case of nested parentheses, the innermost parentheses are evaluated 
first. For example, the expression ((A+4)2+1)*B is evaluated as follows, if A=10 and B=3. 


1. At+4 = 14 giving (14/2+1)*B 
2. 14/2 = 7 giving, (7+1)*B 
3. 7+1 = 8 giving 8*B 

4 8*B = 24 giving 24 


ABSOLUTE AND RELOCATABLE EXPRESSIONS 


An expression is absolute if its value is unaffected by program relocation. It is relocatable if 
its value is changed by program relocation. 


Absolute Expressions 


An absolute expression may contain relocatable terms (RT) alone, or in combination with 
absolute terms (AT), provided the following conditions are met. 


1. The relocatable terms must be paired or used in a relational 
operation. The terms in a pair must have opposite signs, but do not 
have to be contiguous, as in the example: RT+AT-RT. Each pair 
must be relocated to the same location counter. 


2. A relocatable term or. expression must not enter into a 
multiplication, division, or logical operation. For example: 
RT-RT*10 is invalid, while (RT-RT)*10 is valid. 


3. The result of a relational operation is absolute regardless of the 
relocatability of the terms or expressions used in the operation. 


4. Relocatable terms or expressions used in a relational operation are 
considered absolute. The relocatability attribute is disregarded. Thus 
RT<LT>RT is valid even if the two terms or expressions do not 
appear in the same control section. 


5. If an expression that enters into a relational operation has multiple 
relocation attributes, an error indicator is given and the operation is 
performed as if the value of the expression were absolute, for 
example: RT <EQ>RT1+RT7Q. 
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Relocatable Expressions 


A relocatable expression reduces to a single relocatable value. A relocatable expression may 
contain relocatable terms alone, or in combination with absolute terms, provided the 
following conditions are met. 


1. All the relocatable terms but one must be paired, or be involved in a 
relational operation. 


2. The leftover relocatable term must not be directly preceded by a 
minus sign. 
3. No relocatable term may enter into a multiplication, division, or 


logical operation. 


Examples of Absolute and Relocatable Expressions 


The following examples illustrate absolute and relocatable expressions. A is an absolute 
term; BR1 and CR1 are relocatable terms within the current control section. XR2 ts a 
relocatable term in a control section different from that in which BR1 and CR1 are defined. 
Examples of absolute and relocatable expressions are: 


Absolute Expressions Relocatable Expressions 

A-BR1+CR1 A*A+BR1+XR2-CR1 

A BR1 

BR1+A-CR1 BR1+CR1-* 

BR1+(XR2<LT>CR1)+A-CR1 (BR1<EQ>XR2)*10+CR1 
CODING FORM 


Figure 2-12 illustrates a source code form provided for convenience to the programmer and 
the keypunch operator. Since assembler statements are free form, the various fields (name, 
operation, operand, and comment) need not begin in any specified column. The only 
restrictions are that the fields appear in the sequence shown, be separated by one or more 
spaces, and the name field begin in column 1. If the name field is omitted, the operation 
field can begin in any column after column 1. 


All statements are contained in columns 1 through 72. Columns 73 through 80 are reserved 
for identification and statement sequencing. Thus, column 1 is called the begin column and 
column 72 the end column. The standard begin and end columns can, however, be altered 
by the ICTL assembler statement. (This statement is described in Chapter 6. Program 
Control Statements.) 
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Assembler Coding Form Punching Instructions 
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NAME FIELD 


If the name field is included, it must begin in the begin column (column 1). If the name 
field is omitted, the begin column must be blank. A name cannot be more than eight 
characters long after substitution, and cannot be continued on the next line. 


OPERATION FIELD 


The operation field begins after the first blank column. More than one blank column can 
separate the name field and the operation field; however, within the operation field, blanks 
are not allowed. The operation field after substitution cannot be more than eight characters. 
It cannot be continued. 


OPERAND FIELD 


Operands identify or describe data used in a statement. An operand may be actual data, a 
storage address, a register number, a field length, mask, etc. A comma must separate 
operands; embedded blanks or spaces are not allowed, except in strings. 


COMMENT FIELD 


To include comments on the same line as an existing statement, the programmer must begin 
the comment at least one space after the operand field. A comment cannot extend past the 
end column (column 72). An asterisk (*) or a period and asterisk (.*) starting in the begin 
column indicate a comment statement. The asterisk is used for commentary notes on the 
source program; the period and asterisk are used for comments in a macro definition. 
Comments do not affect the assembled program, but are printed in the assembly listing. 


The following example illustrates the name, operation, operand, and comment fields. LOAD 
REGISTER on the first line is a comment because a space separates it from the last operand. 
The asterisk on the second line in column 1 specifies that all characters on that line are 


comments. 


OPERATION 


OPERAND 


NAME 


10 11 12 13 14 15 16 17 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


“Phot ae peer: epee 


i.e 8 oe 5G EB 


a re) 4 ‘ Pie | ee See) 1 See Ae a ee 


IDENTIFICATION-SEQUENCE FIELD 


The identification-sequence field is used for identification or sequencing of statements. This 
optional field is normally contained in positions 73-80. The contents of the field appear in 
the source listing. The programmer may verify the statement sequence by the use of the 
ISEQ assembler statement (discussed in Chapter 6). 
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STATEMENT CONTINUATION 


A semicolon (;) indicates that a statement is continued to the next line. The first non-blank 
character in the next line is the start of the continuation line. Therefore, a blank cannot be 
the first character of a continuation line. Only one continuation line is allowed for source 
statements, except for macro instructions, prototype statements, and GBL statements. Any 
characters after a semicolon are ignored by the assembler and considered as comments. A 
semicolon preceded by an escape character retains its literal value. The first non-blank 
character of a continuation line cannot be a semicolon; nor can a continuation line be 
entirely blank. 


The operands in the following example are two character constants: ACCOUNT; and 
TOTAL EQUALS THE FOLLOWING. The first semicolon retains its literal value because it 
is preceded by an escape character. The second semicolon indicates to the assembler that the 
second operand is continued on the next line beginning with the first non-blank character. 
HEADINGS, which appears after the semicolon, is a comment. Note that the blank between 
TOTAL and EQUALS must be coded on the first line, not in the continuation line. 


OPERAND 


OPERATION 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


C. ACCOUNT#;".C' TOTAL. HEADINGS. 
QUALS. THE’ FOLLOWING: ' - 


a ee ee CC Sa ces ORE Rees Reins Onewen ORnenne Denn -4— AL t ae a ta at Be kee ML. 
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3. MACHINE INSTRUCTIONS 


SOURCE STATEMENTS 
Machine instruction source statements consist of: 


e Name field (optional) 


® Mnemonic operation code 
@ Operand field 
e Comment field (optional) 


An example of a machine instruction source statement is given below. (The data flow of 
most machine instructions is operand 1->operand 2.) 


OPERATION 


NAME OPERAND 


19 20 21.22 23 24 25 26.27 28 29 30 31 32 33 34 36 36 37 3839 40.41 42 43.44 45 46 47 48 49 50 


AMOUNTCRI).,R2. THIS SETS UP R2 


12.3.4 5 6 7 8/9| 10 11 1213 14 15 16 17 
a eo 


INSTRUCTION ALIGNMENT AND CHECKING 
All machine instructions are aligned by the assembler on even-byte boundaries. The 
assembler advances the current location counter the amount necessary to ensure correct 
alignment of the assembled instructions. The contents of the area between the prealignment 
location counter and the postalignment location counter is unchanged. All expressions that 
specify storage addresses are checked to ensure appropriate alignment for the instruction 
format in which they are used. 
OPERANDS AND SUBOPERANDS 
Machine instructions have 0, 1, or 2 operands. Operands are written as a single operand, or 
as an operand with 1 or 2 suboperands. The possible formats of an operand are shown 
below. 

op 

op(subop) 

op(,subop) 


op(subop,subop) 
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Operands specify immediate values, memory locations, or general register numbers, while 
suboperands specify explicit lengths or index registers. 


If indexing is not desired for an instruction, the suboperand used for indexing is omitted. 
General register zero cannot be used by machine instructions as an index. Its specification as 
an index is flagged as an error. 


The at-sign (@) in the first character position of an operand specifies indirect addressing of a 
memory address or general register, as in the following example. 


OPERATION OPERAND 


Leow 8 67-8 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38.39 40 41 42 43.44 45 46 47 48 49 50. 


BADDRESCREGI.).,OREG2 .. 


10 11 1213 14 15 16.17 
LOD. . 
NAME AND LENGTH ATTRIBUTES 

Any machine instruction statement may be named by a symbol, to which other assembler 
statements can refer. The value attribute of the symbol is the address of the leftmost byte 


assigned to the assembled instruction. 


The length attribute may be 2, 4, 6, or 8, depending upon how many bytes are used for an 
instruction. 


The length field of 6 or 8 byte instruction formats can be explicit or implied. To imply a 
length, the length suboperand is omitted. The omission indicates that the length field is 
either the length attribute of the expression specifying the effective address, or the length of 
the literal. 

The length attribute of an expression is the length attribute of the leftmost (or only) term in 
the expression. 

NOTATION USED TO DESCRIBE MACHINE INSTRUCTIONS 


The source formats of the operands are defined using the following symbols. 


Op Code _ The operation codes are presented in hexadecimal (00 through FF). 


R Absolute expression specifying a general register number, 0-7. The register 
may be used as a sending or receiving field (0-7), or as an index register 
(1-7 only). 

E Absolute expression specifying an extended register, 0-15 (for RDX and 
WRX only). 

M Absolute or relocatable expression that specifies a memory address, 


0-65,535. 
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| An absolute expression specifying an immediate value; the value varies 
depending on the instruction. The value may represent an amount used in 
an arithmetic operation, a shift count, a skip count, or a bit number. 


L Absolute expression specifying a field length, usually 0-255, but longer for 
some instructions. For certain instructions the length of an operand field 
may be defined in the instruction. The length specified in the instruction 
overrides any previous field length definition, but is only in effect for that 
instruction. 


@ An at-sign (@) in a source operand indicates indirect addressing, an 
optional feature. For the instructions in which a register is a sending or 
receiving field, the at-sign indicates indirect addressing for R71 or R2. Ifa 
field in memory is the sending or receiving field, the at-sign indicates 
indirect addressing of Mj or M2. 


() Index registers and field lengths are optional; they are enclosed in 
parentheses in a source operand. A source operand using both an indexing 
and a field length specification would be represented like this: 
M1(L7,R1). The comma in the parentheses must not only be coded when 
both the length and index register are used, but also if the second operand 
is used, as follows: M4(L71) or M4(,R71). This enables the assembler to 
distinguish between the two specifications in parentheses. 


e A bullet following a mnemonic indicates the operands are 
byte-addressable; all other operands are word-addressable only. 


An R, M, |, or L in source operand 1 is identified as R1, M1, 11, or L1; in source operand 2 
they are identified as R2, M2, I2, or Loa. 


The two major operand fields must be separated by a comma; no blanks are allowed 
anywhere in the operand fields. 


Remember that the at-sign and any designations in parentheses (field length and index 
registers) are almost always optional; if any of these designations are not optional, this fact 
will be noted. Data flow is usually operand 1 to operand 2, unless stated otherwise. 


SUMMARY OF MACHINE INSTRUCTIONS 


The MRX 40/50 System machine instruction set is divided into two major categories: 
General-Purpose instructions and System instructions. General-purpose instructions are the 
instructions needed to solve most data processing problems using a defined software system. 
System instructions are specialized instructions used to interpret and alter a software 
system. 
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The General-Purpose instructions may be used at any time; the System instructions require 
certain preconditions and cautions. For information on using the System instructions refer 
to the publication 7200 or 7300 Processing Unit Reference. 


Within these two major categories, the instructions are divided into functional groups, and 
these functional groups are listed in alphabetical order, as shown in the following table. 


General Purpose Instructions System Instructions 


Arithmetic Control 
Bit-Oriented I/O 
Boolean Logic 

Branching 

Compare 

Control 

Data Conversion 

Data Transfer 

Shift 

Optional: Floating Point 


The instructions in each functional group are listed alphabetically by mnemonic. This rule 
holds for all instructions except for logical pairs or groups of instructions — these 
instructions are listed alphabetically according to the first instruction of the pair. For 
instance, PAKX (Pack) will be followed by UNPX (Unpack), and SB (Skip Back 
Unconditional) will be followed by SF (Skip Forward Unconditional). 
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GENERAL-PURPOSE INSTRUCTIONS 


. Arithmetic 


Mnemonic 


ADD 
ADDD 
ADDI 
ADDK 
ADDM 
ADDR 
ADDT 
DIV 
DIVD 
DIVK 
DIVI 
DIVM 
DIVR 
MPY 
MPYD 
MPYI 
MPYK 
MPYM 
MPYR 
SUB 
SUBD 
SUBI 
SUBK 
SUBM 
SUBR 
SUBT 
ZADK 


Name 


Add Memory-Register 


- Add Direct 


Add Immediate 

Added Packed Decimal e 
Add Memory-Memory 
Add Register-Register 
Add Two-Word 

Divide Memory-Register 
Divide Direct 

Divide Packed Decimal e 
Divide Immediate 

Divide Memory-Memory 
Divide Register-Register 
Multiply Memory- Register 
Multiply Direct 

Multiply Immediate 
Multiply Packed Decimal! @ 
Multiply Memory-Memory 
Multiply Register-Register 
Subtract Memory-Register 
Subtract Direct 

Subtract Immediate 
Subtract Packed Decimal e 
Subtract Memory-Memory 
Subtract Register-Register 
Subtract Two-word 

Zero and Add Decimal e 


Bit-Oriented Instructions 


IBIT 
ROFR 
RONR 
SBIT 
RBIT 
TBIT 
TOFR 
TONR 


Invert Bit e 
Reverse Off-Bit 
Reverse On-Bit 
Set Bit e 

Reset Bit @ 
Test Bit @ 

Test for Off-Bit 
Test for On-Bit 


Boolean Logic Instructions 


AND 
ANDD 


Logical Product Memory-Register 
Logical Product Direct 
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Ad 
B5 


NO ny PP PNM DY FH 


DANO DA NFP APN ODAWA ND FP HPNDN AWA A PAPNWDAOAN F F 


Operands 
@M4(R1),@R9 
14(R74),@R5 

1,,@R5 

My (b4,R4).Mo(L9,R9) 
@M4(R7),@Mo(Ro) 
@R1,@Ro 
@M4(R7),@R9 
@M4(R4),@R> 
14(R4),@RQ 
My(L7,Rq),Mo(Lo,R9) 
14,@R9 
@M4(R7),@M>(Ro) 
@R,,@R> 
@M4(R4),@R> 
14(R4),@R5 

14,@Ro 

My (L4,R4),Mo(L9,R9) 
@M 4(R1),@Mo(R9) 
@R1,@R9 

@M (Ry ),@R9 
1,(R4),@R5 

14,@R9 

M, (L4,R4),Mo(Lo,R9) 
@M 4(R7),@M9(R9) 
@R1,@R> 
@M4(R7),@Ro 
My(L4,R4),Mo(Lo,R9) 


@M4(R4),19 
@R1,@R9o 
@R1,@R95 
@M4(R4),19 
@M4(R4),l9 
@M4(R4),19 
@R1,@R9o 
@R1,@R9o 


@M4(R4),@Ro 
14(Ry ),@Ro 


Boolean Logic Instructions (Continued) 


Mnemonic 


ANDI 
ANDM 
ANDR 
EOR 
EORD 
EORI 
EORM 
EORR 
IOR 
IORD 
iORI 
IORM 
IORR 


Name 


Logical Product Immediate 


Logical Product Memory-Memory 


Logical Product Register-Register 


Exclusive OR Memory-Register 


Exclusive OR Direct 


Exclusive OR Immediate 
Exclusive OR Memory-Memory 


Exclusive OR Register-Register 


Inclusive OR Memory-Register 


Inclusive OR Direct 
Inclusive OR Immediate 


Inclusive OR Memory-Memory 


Inclusive OR Register-Register 


Branching Instructions 


Branch (post-indexing) 
Branch Add One 
Branch Add Two 


Branch on Condition Register False 


Branch on Condition Register True 


Branch Uncond. (pre-indexing) 


Branch if Bit Off 
Branch if Bit On 


Branch to Address in Register 


Branch if Register is Not Zero 


Branch if Register is Zero 


Branch Subtract One 
Branch Subtract Two 
Branch and Save Return 
Skip Back - Uncond. 
Skip Forward - Uncond. 
Skip on Condition False 
Skip on Condition False 
Skip on Condition True 
Skip on Condition True 


- Back 
- Forward 
- Back 
- Forward 


Skip if Reg. 
Skip if Reg. 
Skip if Reg. 
Skip if Reg. 
Skip if Reg. 
Skip if Reg. 
Skip if Reg. 
Skip if Reg. 


Minus - Back 

Minus - Forward 
Plus - Back 

Plus - Forward 

Not Zero - Back 
Not Zero - Forward 
Zero - Back 

Zero - Forward 
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Code 


35 
65 
25 
A6 
B6 
36 
66 
26 
A7 
B7 
37 
67 
27 


ED 
E4 
E5 
E9 
Eg 
EC 
E2 
E3 
EB 
E1 
EO 
E6 
E7 
EA 
BB 
BA 
4B 
49 
4A 
48 
47 
46 
45 
44 
43 
42 
41 
40 


Lgth 


N 


NNN NON NYONN NNN NNN FS FSF PP PND SPH HH HPPA FS 


NON PP NH ON fF PN OD 


Operands 


14,@R5 
@M4(R1),@M(R5) 
@R1,@R95 
@M4(R4),@R9 
14(R4),@Ro 
14,@R9 
@M,(R7),@Mo(Ro) 
@R1,@Ro 
@M4(R4),@Ro 
14(R4),@Ro 
1,,@Ro 
@M4(R7),@Mo(Ro) 
@R1,@R9 


@M4(R1) 
@M4(R4),@Rg 
@M4(R1),@R9 
@M, (Ry ),t9 
@M4(Ry AD) 
@M4(R4) 
@M4(R4),I9 
@M4(R4),!9 
@R, 
@M4(R1),@Ro 
@M4(R4),@Ro 
@M4(R1),@R9 
@M4(R41),@R9 
@M4(R47),@R9 


Compare Instructions 


Mnemonic 


CBY | 
CBYM 
CMP 

CMPD 
CMPI 

CMPK 
CMPM 
CMPR 
CMPT 
CMPX 


Name 


Compare Byte Memory-Register @ 
Compare Byte Memory-Memory e 
Compare Memory-Register 
Compare Direct 

Compare Immediate 

Compare Packed Decimal e 
Compare Memory-Memory 
Compare Register-Register 
Compare Two-Word 

Compare Characters e 


Control Instructions 


General Purpose Control instructions can be used at any time without preconditions; compare with System 


Control instructions. 


NOP 
RDX 
SR 


No Operation 
Read Extended Register 
Service Request 


Data Conversion Instructions 


CVB 

CVBT 
CVD 

CVDT 
EDTX 
PAKX 
UNPX 
TRNX 


Convert to Binary e 

Convert to Binary Two-Word e 
Convert to Decimal e 

Convert to Decimal Two-Word e 
Packed Decimal/Alpha Edit e 
Pack e 

Unpack e 

Translate e 


Data Transfer Instructions. 


CLDOR 
CSTR 
INV 
INVD 
INV} 
INVM 
INVR 
LOD 
LODB 
LODD 
LODI 
LODT 
MOVB 


Condition Register Load 
Condition Register Store 
Inverse Move Memory-Register 
Inverse Move Direct 

Inverse Move Immediate 
Inverse Move Memory-Memory 
Inverse Move Register-Register 
Load Memory-Register 

Load Byte e 

Load Direct 

Load Immediate 

Load Two-Word 

Move Byte e 
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Code 


FQ 
6B 
Al 
B1 
31 
51 
61 
21 
71 
55 


EE 
FO 
13 


AA 
AA 
AB 
AB 
57 
58 
59 
56 


2B 
2A 
A4 
B4 
34 
64 
24 
AO 
F7 
BO 
30 
70 
6A 


Lgth 


DH ND DAN FAH A 


Ny + 


an ao anorth fh ff 


OPnO FPF PFHNYD ON FP PN NO 


Operands 


@M4(R4),@R9 
@M4(R4),@Mo9(Ro) 
@M4(R1),@R9 
I4(R4),@R9o 

1,,@R5 
My(Ly,R4),Mg(L9,R9) 
@M 4(R7),@M9(R9) 
@R1,@Ro 
@M4(R4),@Ro 
M4(L7,R4),Mg(Lo,R9) 


Blank or @M4(R4),R9 
E,,R9 
@l, 


@M4(R4),Ro 
@M4(R4),Ro 
@M4(R4),R9 
@M,4(R4),Ro 
My(L4,R4),Mo(Lo,R9) 
M4(L4,R4),Ma(Lo,R9) 
M4(L4,R4),Mg(L9,Ro) 
M4(R1),Mo(L9o,R9) 


@R, 

@Ry 
@M4(R1),@Ro 
14(R4),@Ro 
14,@Ro 
@M4(R4),@Mo(R9) 
@R1,@Ro 
@M4(R71),@Ro 

@M 4(R7),@Ro 
14(R4),@Ro 
1,,@R> 
@M1(R7),@Ro 
@M4(R4),@Ma(R9) 


Data Transfer Instructions (Continued) 


Mnemonic Name 

MOVL Move Long @ 

MOVM Move Memory-Memory 
MOVR Move Register-Register 
MOVX Move Characters @ 
PSTR Program Address Store 
STO Store Memory-Register 
STOB Store Byte e 

STOT Store Two-Word 


Shift Instructions 


ARDI Arithmetic Right Double Shift - 
Immediate 
ARDR Arithmetic Right Double Shift - 
By Register 
ARSI Arithmetic Right Single Shift - 
Immediate 
ARSR Arithmetic Right Single Shift - 
By Register 
LLDI Logical Left Double Shift - Immediate 
LLDR Logical Left Double Shift - By Register 
LLSI Logical Left Single Shift - Immediate 
LLSR Logical Left Single Shift - By Register 
LRDI Logical Right Double Shift - Immediate 
LRDR Logical Right Double Shift - By Register 
LRSI Logical Right Single Shift - Immediate 
LRSR Logical Right Single Shift - By Register 
RLDI Rotating Left Double Shift - 
Immediate 
RLDR Rotating Left Double Shift - 
By Register 
RLSI Rotating Left Single Shift - !mmediate 
RLSR Rotating Left Single Shift - By Register 
SHFK Shift Packed Decimal e 


Floating Point Instructions (Optional) 


ADDF Add Floating Point 

CMPF Compare Floating Point 

DIVF Divide Floating Point 

FLT Convert Fixed to Float 

FLTT Convert Fixed to Float Two Word 
INT Convert Float to Fixed 

INTT Convert Float to Fixed Two Word 
LODF Load Floating Point Register 

MPY F Multiply Floating Point 

NEGF Negate Floating Point Register 
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Code 


5A 
60 
20 
54 
3A 
FA 
F8 
FB 


5F 
3F 
4F 
2F 


5C 
3C 
4c 
2C 
5D 
3D 
4D 
2D 
5E 


3E 


4E 
2E 
3B 


86 
87 
89 


82 
82 
81 
81 


84 
88 
80 


Lgth 


oO 


MRM NM NM NN NM NY NY N fh FP PNM WN OD 


Npp NNNMN PB BB 


Operands 


M,(L4,R4),M9(R9) 
@M1(R1),@Mo(R9) 
@R1,@R9 

M, (L4,R4),Mo(Lo,R9) 
@R, 

@M4(R4),@Ro 
@M41(R7),@Ro 
@M41(R1),@Ro 


14,R9 


@R1,R9 


Iq,Ro 


@R1,Ro 


14,Ro 
@R1,Ro 
1y,Ro 
@R1,Ro 
14,R9 
@R1,Ro 
I4,Ro 
@R1,R9 
14,Ro 


@R1,Ro 


14,Ro 
@R4,Ro 
M,(L4,R4),!o(Ro) 


@M4(R4),R9 
@M4(R4) 
@M 4(R4),R9 
@R4 

@R4 
@R1,R9 

@R 7,Ro 
@M4(R4),R9 
@M4(R4),R9 


Floating Point Instructions (Optional) (Continued) 


Mnemonic Name 
STOF Store Floating Point Register 
SUBF Subtract Floating Point 


SYSTEM INSTRUCTIONS 


Code 


8A . 
85 


Lgth 


4 
4 


Operands 


@M,(R4) 
@M4(R4),Ro 


Privileged and restricted classes; consult 7200 or 7300 Processing Unit Reference manual for information 


on the use of these system instructions 


Control Instructions 


Mnemonic Name 

CTB Clear Tie-Breaker Register 

TST Test and Set Tie-Breaker Register 
BCM Branch to Control Memory 
RAR Read Any Register 

WAR Write Any Register 

RRO Read Register - Option Register 
WRO Write Register - Option Register 
SAR Save All Registers 

RSAR Restore All Registers 

SBA Set Busy/Active Register 

RBA Reset Busy/Active Register 
SCN Set Control Register 

RCN Reset Control Register 

SPM Set Privileged Mode Register 
RPM Reset Privileged Mode Register 
WRX Write Extended Register 


1/O Instructions 


DIO Disc Input/Output 

INP Input from 1/O Register 

OUT Output to 1/O Register 

RDC Communications Input/Output 
WRC Communications Output 

SiO System Input/Output 


Code 


12 
11 

EF 
FE 
FE 
FD 
FD 
FF 
FF 
10 
10 
14 
14 
15 
15 
FO 


F2 
F5 
F6 
F3 
F4 
F1 


Lgth 


NO 


OM NM NYO NMO NN Ff SP PP PHD ND 


NO NM NM NY NY NY 


Operands 


Ry,I9 

14(R4),@Ro 

14(R4),@Ro 

14(R7),@Ro 

14(R4),@Ro 

M4(R4), 19 or Mq(Ry),@Ro 
M1(R4),12 or M4(R4),@Ro 
14,9 or @Ry,I9 

14,19 or @Ry,19 

14,19 or @Ry,19 

I4,!9 or @R},I9 

14,12 or @Ry,19 

14,19 or @Ry,19 

E4,R9 


@R41,R9 
14,@R9 
14,@R9 


R4,Ro 
@R1,R9 


SUMMARY OF EXTENDED MNEMONICS 


The assembler provides extended mnemonic codes which allow unconditional skips, and 
conditional skips and branches to be written in a symbolic form that is easier to use than 
standard machine instructions. The assembler translates the extended mnemonic codes into 
machine instruction object code. 


Extended mnemonic codes for skip instructions do not specify the forward (F) or backward 
(B) direction of the skip. Thus, the extended mnemonic, S, can be used instead of the SF or 
SB machine instruction. The assembler determines the direction of the skip for the S 
instruction from the memory address or immediate value in the operand. For example, S 
DOG skips to the address, DOG, whether DOG is before or after the present location 
counter. 


Extended mnemonic codes for branch and skip instructions that test the condition register 
specify the condition in the mnemonic itself rather than in the operand for example. SOV 
ADDRS skips to ADDRS if overflow has occurred. The standard machine instruction names 
the direction and the bit status in the mnemonic, and the actual bit number tested in the 
operand. Thus, the extended mnemonic SOV 4 is the same as the standard instruction SCTF 
4,0. (Bit 0 of the condition register is the overflow bit.) 


The extended mnemonic codes are grouped as follows: 


e Address Coded Skips 

@ After Arithmetic Instructions 

© After Compare Instructions — Arithmetic Test 
e After Compare Instructions — Logical Test 

e After Decimal Instructions 

6 After PAKX Instruction 

e After TBIT Instruction 

e Conditional Register Test 


Just as for the standard instructions, indirect addressing and indexing are optional for the 
extended mnemonic codes. 
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EXTENDED MNEMONIC CODES 


Address-Coded Skips 


Extended Code Machine Instruction Meaning 

S M, or |, SF 1 Skip forward or backward 
SB 14 

SRZ My,R9 or 14,R9 SRZF  14,Ro Skip if reg. is zero, forward or 
SRZB_ 14,R9 backward 

SRN M4,R9 or 14,R9 SRNF  14,R9 Skip if reg. is non-zero forward or 
SRNB backward 

SRP My,R9 or 14,Ro SRPF  14,R9 Skip if reg. is plus, forward or 
SRPB~ 14,R9 backward 

SRM M4,R9 or 14,R9 SRMF_ 14,R9 Skip if reg. is minus, forward or 
SRMB_ 14,R9 backward 


For S, the !4 value = -255 through +255; for all other extended mnemonics in this category, |4 = -15 
through +15. 


For SF and SB, the |4 value = 0-255; for all other regular instructions in this category I4 = 0-15. 


After Arithmetic Instructions 


BOV @M4(R4) BCT @M4(R4),0 Branch if overflow 
BNV @M4(R4) BCF @M;4(R4),0 Branch if no overflow 
BCY @M,(R}4) BCT @M,(R}4),3 Branch if carry 
BNC @M,(R}4) BCF @Mj,(R}j),3 Branch if no carry 
SOV M, or ly SCTF 14,0 Skip if overflow 
SCTB 14,0 
SNV My, or |, SCFF 14,0 Skip if no overflow 
SCFB 14,0 
SCY M, or |, SCTF 14,3 Skip if carry 
SCTB 14,3 
SNC My or |y SCFF 14,3 Skip if no carry 
SCFB 14,3 


I, = -15 through +15 for the extended instructions. |, = 0-15 for the regular instructions. 


After Compare Instructions — Arithmetic Test 


The arithmetic test tests the result of a signed arithmetic compare between operand 1 and operand 2. In 
the following table, 1 and 2 under Meaning refer to the signed values of operands 1 and 2. 


Extended Code Machine Instruction Meaning 

BGT @M4(R4) BCT @M4(R4),1 Branch if 1 GT 2 
BLT @M4(R4) BCT @M4(R4),2 Branch if 1 LT 2 
BGE @M4(R4) BCF @M4(R4),2 Branch if 1 GE 2 
BLE @M4(R4) BCF @M4(R4),1 Branch if 1 LE 2 
BEQ @M,(R}) BCT @M4(R4),3 Branch if 1 EQ 2 
BNE @M (R41) BCF @M4(R4),3 Branch if 1 NE 2 
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After Compare Instructions — Arithmetic Test (Continued) 


Extended Code Machine Instruction Meaning 

SGT M, or ly SCTF 14,1 Skip if 1 GT 2 
SCTB 14,1 

SLT My, or 14 SCTF 14,2 Skip if 1 LT 2 
SCTB 14,2 

SGE M, or |y SCFF 14,2 Skip if 1 GE 2 
SCFB 14,2 

SLE M, or 14 SCFF 14,1 Skipif1 LE 2 
SCFB 1y,1 

SEO My or |y SCTF 14,3 Skip if 1 EQ 2 
SCTB 14,3 

SNE My, or |y SCFF 14,3 Skip if 1 NE 2 
SCFB 14,3 


14 = -15 through +15 for extended instructions. |, = 0-15 for regular instructions. 


After Compare Instructions — Logical Test 


The logical test tests the results of an unsigned arithmetic (logical) compare between operand 1 and operand 
2. In the following table, 1 and 2 under Meaning refer to the unsigned values of operands 1 and 2. CMPX 
and all variations of the CBY instruction always yield a logical result. 


Extended Code Machine Instruction Meaning 

BLGT @M,(R}) BCT @M4(R4),5 Branch if 1 GT 2 

BLLT @M,(R1) BCT @M4(R4),6 Branch if 1 LT 2 

BLGE @M,(R}4) BCF @M4(R4),6 Branch if 1 GE 2 

BLLE @M,(R}) BCF @M4(R4),5 Branch if 1 LE 2 

BLEQ @M,(R}) BCT @M4(R4),7 Branch if 1 EQ 2 

BLNE @M,(R}) BCF @M4(R4),7 Branch if 1 NE 2 

SLGT Mj, orl, SCTF 14,5 Skip if 1 GT 2 
SCTB 14,5 

SLLT My or ly SCTF 14,6 Skip if 1 LT 2 
SCTB 14,6 

SLGE My, orl SCFF 14,6 Skip if 1 GE 2 
SCFB 14,6 

SLLE Mj, orl, SCFF 14,5 Skipif1 LE 2 
SCFB 14,5 

SLEQ My, orl, SCTF 14,7 Skip if 1 EQ 2 
SCTB 14,7 

SLNE My, or ly SCFF 14,7 Skip if 1 NE 2 
SCFB 14,7 


ly =-15 through +15 for the extended instructions. |, = 0-15 for the regular instructions. 


After Decimal Instructions 


BKP @M,(R}) BCT  @M,(Rj),1 Branch if plus 
BKM  @M,(R}) BCT @M4(R,),2 Branch if minus 
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After Decimal Instructions (Continued) 


Extended Code Machine Instruction Meaning 

BKZ  @M,(Rj) BCT  @M,4(Rj),3 Branch if zero 

SKP M, or ly SCTF 14,1 Skip is plus 
SCTB 141 

SKM My or ly SCTF 14,2 Skip if minus 
SCTB 14,2 

SKZ My or ty SCTF 14,3 Skip if zero 
SCTB 14,3 


14 =-15 through +15 for the extended instructions. 14 = 0-15 for the regular instructions. 


After PAKX Instruction 


BID @M4(R4) BCT @M4(R4),4 Branch if invalid digit 

BNI @M4(R4) BCF @M4(R4),4 Branch if no invalid digit 

SID My, or ty SCTF 14,4 Skip if invalid digit 
SCTB 14,4 — 

SNI M, or ly SCFF 14,4 Skip if no invalid digit 
SCFB 14,4 


I, =-15 through +15 for the extended instructions. 14 = 0-15 for the regular instructions. 


After TBIT Instruction 


BBS @M4(R4) BCT @M4(R4),0 Branch if bit.is set 

BBR @M4(R4) BCF @M4(R4),0 Branch if bit is reset 

SBS M, or |, SCTF 14,0 Skip if bit is set 
SCTB 14,0 

SBR M, or |, SCFF 14,0 Skip if bit is reset 
SCFB 14,0 


I, =-15 through +15 for the extended instructions. 14 = 0-15 for the regular instructions. 


Condition Register Test 


SCF My,!9 or 14,19 SCFF 14,1 Skip if bit spec. by Io is off 
SCFB 14,| 

SCT M,,l9 or 14,19 SCTF 14,1 Skip if bit spec. by I9 is on 
SCTB 14,1 


Iq = -15 through +15 and Ip = 0-15 for the extended instructions. |4 and Ip = 0-15 for the regular 
instructions. 
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4. ASSEMBLER INSTRUCTION SOURCE 
STATEMENTS — OVERVIEW 


Assembler statements are requests to the assembler to perform certain operations during the 
assembly. Some statements, such as WDD and BDD, generate data, while others, such as 
EQU and SPACE, are effective only at assembly time. A summary of assembler statements 
can be found in Appendix E. 


Assembler instruction source statements consist of: 


Name field (usually optional) 
Mnemonic operation code 
Operand field (optional for some statements) 


Comment field (optional) 


An example of an assembler instruction source statement is: 


OPERAND 


The following is a list of assembler statements with a short explanation for each statement. 


Program Sectioning and Linking Statements 


CSECT 


ENTRY 


EXTRN 


COM 


Identifies the beginning or continuation of a control section 


Identifies relocatable symbols defined in the current program that are 
used in another program 


Identifies relocatable symbols used in the current program that are 
defined in another program 


Identifies the beginning or continuation of a common control section 


Program Control Statements 


ORG 


END 


PUNCH 


Sets the location counter 
Ends the assembly 


Writes data in a user-defined file 
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LTORG Assembles literals in a pool 

ICTL Specifies nonstandard input format 

ISEO Checks the lines of code for the correct sequence 

ALIGN _ Sets the current location counter to a storage boundary 
Linkage Editor Map Address Directive Statement 

SEG Defines load-module segment 
Symbol and Data Definition Statements 

EQU Defines a symbol and assigns values and attributes to it 

WDD Defines word aligned data (in bytes) 

BDD Defines byte aligned data (in bytes) 

WRS Reserves word aligned storage (in words) 

BRS Reserves byte aligned storage (in bytes) 

FORM _ Defines bit-oriented formats (in storage bytes) 
Listing Control Statements 

TITLE Identifies the listing 

EJECT Starts anew page 

SPACE _ Inserts blank lines 

PRINT Specifies the details to be printed 
Macro Definition Statements 

MACRO _ Begin macro definition 

MEXIT Conditional exit from macro definition 


MEND End macro definition 


MNOTE Macro message 
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Conditional Assembly Statements 


SETA 


SETC 


GBLA 


GBLC 


ADO 


AGO 


ANOP 


Assigns arithmetic values to set symbols 
Assigns character values to set symbols 
Defines a SETA symbol as global 

Defines a SETC symbol as global 

Sets up a source statement generation loop 
Specifies a branch to another statement 


Specifies an assembly no-operation statement 
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5. PROGRAM SECTIONING AND LINKING STATEMENTS 


The programmer can divide a lengthy or complex program into control sections to make it 
more manageable and easier to debug. Each section is assigned a unique name. The operating 
system treats each section as an independent, relocatable routine that can be executed alone 
or linked with others. 

During assembly, the assembler creates an index of all assigned control section names. At 
load time, the Linkage Editor uses the index to link the various control sections into a single 
storage module, from which the connected sections can be executed as a complete program. 


The assembler mnemonics and functions of the program sectioning and linking statements 
are: 


CSECT Identifies the beginning or continuation of a control section. 


ENTRY Identifies relocatable symbols defined in the current program that are used 
in another program. 


EXTRN Identifies relocatable symbols used in the current program that are defined 
in another program. 


COM Identifies the beginning or continuation of a common control section. 


(The reserved symbolic segment tag, $SYSEG, is also explained in this section.) 


CSECT — IDENTIFY CONTROL SECTION 


The CSECT statement identifies the beginning or continuation of a control section. The 
format of the CSECT statement is: 


Operation Operand 


Symbol or CSECT Not used — ignored by the 
blank assembler 


If a symbol appears in the name field, it is the name of the control section; otherwise, an 
unnamed control section is defined. The symbol in the name field represents the address of 
the first byte of the control section. It has a length attribute of 1. 


To preclude the generation of an unnamed CSECT section; the CSECT statement must 
precede all statements except the following: macro and FORM definitions, listing control 
statements, conditional assembly statements, |CTL and ISEQ statements, EXTRN and 
ENTRY statements, PUNCH statements, and comments. 


if the assembler encounters a statement other than these before a CSECT statement, an 
unnamed CSECT statement is generated. 


All statements following the CSECT statement are assembled as part of that control section 
until another CSECT or COM statement is encountered. A control section can be 
interrupted and then resumed by inserting another CSECT statement with the same name, 
as in the following example. Contro! section ONE includes all code between the first ONE 
CSECT card and the TWO CSECT card plus all code following the second ONE CSECT card. 
Unnamed control sections can also be resumed. 


ONE CSECT 

Control section ONE 
TWO CSECT 

| Control section TWO 
ONE CSECT 


| Control section ONE 


SYMBOLIC LINKAGE STATEMENTS — ENTRY AND EXTRN 


The symbolic linkage statements, ENTRY and EXTRN, allow a symbol to be defined in one 
program and referred to in another program. The program defining the symbol uses the 
ENTRY statement; the program referencing the symbol uses the EXTRN statement. In both 
instances, the assembler provides the linkage editor with the information to resolve the 
symbolic linkage. 


ENTRY — IDENTIFY ENTRY POINT SYMBOL 


The ENTRY statement specifies which relocatable symbols defined in the current program 
can be accessed by other programs. The format of the ENTRY statement is: 


Operation 


Sequence One or more relocatable 
symbol symbols separated by comma 
or blank 


The symbols in the operand field may be used as operands by other programs. Control 
sections named in CSECT or COM statements are automatically considered entry points and 
do not have to be listed in an ENTRY statement. In the following example, the ENTRY 
statement identifies SUB1 and SUB2 as entry points to the program: 


OPERATION OPERAND 


EXTRN — IDENTIFY EXTERNAL SYMBOL 


The EXTRN statement identifies relocatable symbols that can be used in the current 
program, although they are defined elsewhere. The format of the EXTRN statement is: 


One or more relocatable 
symbols separated by commas | 


Operation 


Sequence EXTRN 


symbol 
or blank 


Symbols named in the operand field cannot appear in an ENTRY statement in the same 
program. The combined total of control section and external symbols in the same program 
cannot exceed 252. 


The example in Figure 5-1 shows how two programs, PROGA and PROGB, use EXTRN and 
ENTRY, so PROGA can use symbols defined in PROGB. EXTRN in PROGA identifies 
FETCH as a symbolic address that is defined in another program. ENTRY in PROGB 
defines FETCH as an entry point in PROGB. Thus PROGA can use FETCH as an operand 
without first defining it. 


OPERAND 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 
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Figure 5-1. Example of EXTRN and ENTRY 
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COM — DEFINE COMMON CONTROL SECTION 


The COM statement identifies the beginning or continuation of a common control section. 
The format of the COM statement is: 


Name 


Operation Operand 
Symbol COM Not used — ignored by 
or blank the assembler 


If a symbol appears in the name field, it is the name of the common storage area; otherwise, 
an unnamed common storage area is defined. An unnamed COM control section does not 
have the same name as an unnamed CSECT section. If two COM statements with the same 
name appear in the same program, the second is a continuation of the first. When COM 
statements are assembled, the common location assignment starts at zero. The symbol in the 
name field represents the address of the first byte of the control section. It has a length 
attribute of 1. 


Since a COM control section’s primary function is to define the structure of a storage area 
used by more than one program, no binary data can be generated by statements within the 
COM section. However, pertinent storage information such as address assignment, 
relocatability, and length attributes are retained and assembled in the normal way, without 
binary output. 


Data can be stored in a common storage area during assembly only by a CSECT control 
section in a different assembly, in which case the CSECT control section must use the same 
name as the common area defined and reserved by COM statements. After the programs are 
assembled and the Linkage Editor has performed the necessary linkage, data can be 
retrieved, stored, checked, and manipulated in the common area by any cognizant program 
currently being executed. 


No more than one CSECT control section may be included in a set of COM control sections 
identified by the same name in the same load module. 


The example in Figure 5-2 shows how two programs communicate information through the 
common area. Each program must know the other’s plan for structuring and using the 
common storage area. If program PROGA is to pass information to PROGB, PROGB must 
know the location in COMMON to which PROGA will pass the data. In this example, 
information is passed through COMMON at location TAGE. In PROGA, the statement STO 
TAG5,R2 stores the contents of register 2 at location TAG5. After the branch is made to 
FETCH, PROGB loads the contents from TAGE (which is the same location as TAGS in 
PROGA) into its register and checks to see if it is equal to the hexadecimal constant: ‘AF’. 
If a true comparison is found, a branch is made to PROGC. Note that when the Linkage 
Editor is called to link the programs at load time, each program is linked to COMMON. 


5-4 


NAME OPERATION OPERAND 
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NAME OPERAND 
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Figure 5-2. Example of the COM Statement 
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RESERVED SYMBOLIC SEGMENT NAME — $SYSEG 


The reserved symbolic segment name, $SYSEG, is a relocatable segment designator which 
makes extended addressing possible. A reserved name has a special meaning to the system 
and should not be used as a symbol for any purpose other than its special meaning. 


Symbolic segment tags are used for address referencing across program (or storage) 
segments. However, a user whose program is limited to one segment need not use segment 
tags. To make all system interfaces (I/O requests and service requests) compatible, addresses 
specified in these interfaces must have an associated segment tag. 


When a single-segment program is written, the assembler assigns the global system name, 
$SYSEG, to the first (and only) segment in the program. $SYSEG is automatically entered 
in the symbol table by the assembler, and thus becomes a reserved identifier. 


The name $SYSEG is used as a default value in all system macros containing address 
parameters. The user must concern himself with $SYSEG only if he is coding system 
interfaces directly without using the regular system macros. 


$SYSEG cannot be used in a multi-term expression. It can only be used as an operand in a 
BDD, WDD, or FORM instruction. If it is used in a FORM instruction, the size of the 
corresponding definition field must be 8 bits in length and start on a byte boundary. The 
length attribute of $SYSEG is 1. 


6. PROGRAM CONTROL STATEMENTS 


The assembler mnemonics and functions of the program control statements are: 
ORG Sets the location counter 
END Ends the assembly 
PUNCH Writes data in a user-defined sequential disk file. 


LTORG Inserts the accumulated literal pool, starting at the current location 
counter. 


ICTL Specifies nonstandard input format. 
ISEQ Checks the lines of code for the correct sequence. 


ALIGN Sets the current location counter to a storage boundary address. 


ORG — SET LOCATION COUNTER 


The ORG statement alters the setting of the location counter. The format of the ORG 
statement is: 


Operation Operand 


Sequence Relocatable expression or 
symbol blank 
or blank ; 


Symbols in the expression must be previously defined. The unpaired relocatable symbol 
must be defined in the same control section in which the ORG statement appears. The 
location counter is set to the value of the expression in the operand, or to its previous high 
count, if the operand field is blank. = 


Since the location counter points to a storage location that is to receive the next line of 
assembled code, altering its setting permits a programmer to return to a previous location in 
his program and change its contents. In this way, an area can be redefined during assembly, 
changing data definitions to meet various requirements in the program. 


An example of an ORG statement is: 


OPERAND 
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If the location named TAG is twelve bytes from the beginning of the control section, this 
statement sets the location counter to OOOC. Statements that follow the ORG statement are 
then assembled beginning at address OOOC. The information previously assembled at these 
locations is lost, although the name tags remain unchanged and cannot be duplicated. 


The ORG statement can also be used in direct reference to the location counter. The format 
of the operand is *-n or *+n. The asterisk specifies the present location counter, and n 
specifies the number of bytes. The following statement decreases the present location 
counter by 60: 


OPERATION i 


OPERAND 
16 16 17] 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38.39 40.41 42 43.44 45 46 47 48 49 50 


“Wo 11 12:13 14 


ORG 


12345678 


An ORG statement without an operand returns the location counter to its previous high 
count, as in the following statement. If the counter has already reached its previous high, an 
ORG without an operand has no effect. 


1 2 e 4 5 6 7 8 9 | 10 1 1 12.13 14 15.16 17 


OPERATION OPERAND 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 3839 40 41 42 4344 45 46 47 48 49 50 


The following example shows an ORG with a location counter reference and an ORG 
without an operand. If the location counter is 0050 when ORG *-20 is encountered, the 
count is decreased by 20 bytes to O03C. Then if the ORG without an operand is 
encountered before the counter reaches its previous high of 0050, the count is returned to 
0050. 


OPERATION OPERAND 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 3839 4041 42 43.44 45 46 47 48 49 50 


For an example of an application of the ORG statement, refer to Figure 8-3 in Chapter 8. 
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END — END ASSEMBLY 


The END statement terminates the assembiy of a program. The format of the END 
statement is: 


Ordinary symbol or blank 


An ordinary symbol in the operand field specifies the point to which control is to be 
transferred when loading is complete. The ordinary symbol must identify a symbolic address 
in the current assembly. Substitution is invalid on the END statement. Continuation is 
ignored on the END statement. 


PUNCH — WRITE TO FILE 


The PUNCH statement writes data in a user-defined sequential disk file. The format of the 


PUNCH statement is: 


Sequence PUNCH Not used 
symbol 
or blank 


The PUNCH statement precedes the line of code that is to be written in the file. The line of 
code can be in any format and it cannot be continued. In the following example, //DEF 
ID=INPUT,FIL=CAT is written in a file defined by the user: 


OPERATION OPERAND 


10 11 12 13 14 16 16 17118] 19 20 21 22 23 24 25 26 27.28 29 30 31 32 33 34 35 36 37 3839 40 41 42 4344 45 46 47 48 49 50 


Variable symbols in the line of code are resolved before the record is written to the file. If 
substitution results in a record that exceeds the standard statement size (columns 1 through 
72) or nonstandard size specified by an ICTL statement, excess characters are truncated on 
the right. 


The PUNCH statement does not lend itself to a fixed field format, because as values of 
various lengths are substituted for a variable symbol, the position of the subsequent fields is 
shifted. 

In the following example, values are substituted for the variable symbols $TAG and $VAL 


before the record is written. 
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NAME 


eae 2 eee 


a eee oe rt eee ere 


If $TAG is equal to AB and $VAL is equal to 75, the record written in the file is: NAME IS 
AB VALUE IS 75. 


If STAG is equal to C‘THIS 1S A MESSAGE’ and $VAL is equal to 10, the record written in 
the file is: NAME IS C’THIS IS A MESSAGE’ VALUE IS 10. 


Notice that the statement VALUE IS. . .is moved to the right to make room for the first 
statement NAME IS... . 


A fixed field format may be established by using a variable symbol with as many characters 
(including the ampersand) as the substituted value. 


LTORG — BEGIN LITERAL POOL 


The LTORG statement assembles previously defined literals into a single area called a literal 
pool. All preceding literals, back to the beginning of the program, or back to the last 
LTORG statement, are assembled at the next word boundary. If a LTORG statement is not 
used, all literals are assembled after the first control! section. Literals that appear after the 
last LTORG statement are also assembled after the first control section. 


The format of the LTORG statement is: 


Name Operation Operand 


Symbol LTORG Not used 
or blank 


A symbol in the name field represents the address of the first byte of the literal pool. The 
length attribute of the symbol is 1. 


ICTL — INPUT FORMAT CONTROL 


The ICTL statement specifies that statements in a program begin and end in columns other 
than the standard columns 1 and 72. The format of the ICTL statement is: 


Ne mon epee ste 


Name Operation Operand 


Not used ICTL Two decimal arithmetic 
constants separated by 


a comma 


Both decimal constants are required. The first constant specifies the beginning column 
(1-40). The second specifies the end column (41-120). A comma must separate the two 
constants. 


If the source program does not contain an ICTL statement, the standard format (columns 1 
and 72) is used.. Because system macros are always processed in the standard format, they 
are not affected by the ICTL statement. 


Since the ICTL statement establishes a new format, it must be the first statement in the 
program and can be used only once. The ICTL statement cannot be continued. 


The following statement establishes column 10 as the begin column and column 90 as the 
end column. 


OPERATION 


OPERAND 


ISEQ — INPUT SEQUENCE CHECKING 


The ISEQ statement specifies that all subsequent statements are to be checked or not 
checked for correct sequence. The format of the ISEQ statement is: 


Blank, or two decimal arithmetic 
constants, separated by a comma 


Name Operation 


Blank ISEQ 


lf the operand field is used, both decimal constants must be specified. The first constant 
specifies the column number of the leftmost character of the sequence field; the second 
constant specifies the column number of the rightmost character of the sequence field. A 
comma must separate the two operands. 


Sequence checking begins with the first line following the ISEQ statement and continues up 
to an ISEQ statement without an operand. Checking can be resumed with another ISEQ 
statement. If each succeeding sequence field is not higher in value than that of the preceding 
statement, a sequence error message is generated. A sequence error does not terminate the 
assembly. 


The columns identified by the ISEQ statement must be between columns 73-80 if the 


standard begin and end columns are used, or outside the begin and end columns defined by 
an ICTL statement. 
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Sequence checking is only performed on statements contained in the source program. Macro 
definitions in a macro library or lines generated by a macro instruction are not checked. 
Lines with a blank sequence field are always considered to be in the correct order. 


The operand field of an ISEQ statement may not contain a reference to a variable symbol. 
The ISEQ statement cannot be continued. 


ALIGN — ALIGN LOCATION COUNTER 


The ALIGN statement sets the value of the location counter to an address determined by a 
value in the operand field; the assembler updates the counter to the next highest address 
which is a multiple of the expressed value in the operand. The format of the ALIGN 
statement is: 


Operation Operand 


ALIGN Absolute 


or blank arithmetic expression 


The operand can be an expression to be evaluated by the assembler; however, all symbols 
must be previously defined. 


In the following example, the location counter is set to the next highest multiple of 4 
addresses. If the location counter is at 1009 when the statement is encountered, it is set to 
100C. However, if the location counter is already set to an address which is a multiple of the 
operand value (1008, 100C, 1010, etc.), the counter is not changed. After alignment, the 
address of the location counter is assigned the symbolic name in the name field. In the 
example, FOUR1 is equal to 100C. The length attribute is always 1. 


OPERAND 


If the counter is set to an address exceeding 65,53510, an error message is generated and 
alignment occurs. The location counter is set to the value exceeding 65,53519. An address 
of 65,60010 will set the location counter to 6410. . 
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7. LINKAGE-EDITOR MAP DIRECTIVE — SEG 


The Linkage Editor map directive, SEG, may be used as an assembly language statement. 
The assembler does not process the statement, but simply writes the directives, in their 
source form, on the output file. 


All SEG statements in an assembly must immediately precede the END statement. The only 
statements that can appear between the SEG statement and the END statement are the 
conditional assembly statements SETA, SETC, ADO, AGO, ANOP, and macro instructions 
generating these statements. A SEG statement cannot be continued and no substitution is 
performed. 


The function and format of the SEG statement is described in the publication MRX/OS 
Program Library Services Reference. 


8. SYMBOL AND DATA DEFINITION STATEMENTS 


The assembler mnemonics and functions of the symbol and data definition statements are: 
EQU Defines a symbol and assigns values and attributes to it. 
WDD Defines word-aligned data (in bytes). 
BDD Defines byte-aligned data (in bytes). 
WRS Reserves word-aligned storage (in words). 
BRS Reserves byte-aligned storage (in bytes). 


FORM _ Defines bit-oriented data formats (in storage bytes). 


EQU — EQUATE 


The EQU statement assigns values and attributes to a symbol. The format of the EQU 
statement is: 


Operation Operand 


Ordinary Expression 
or variable 
symbol 


The expression in the operand field can be absolute or relocatable; however, all symbols in 
the expression must be previously defined. 


The symbol in the name field is given the same length, value, and relocatability attributes as 
the expression in the operand field. The length attribute of the symbol is that of the 
leftmost (or only) term of the expression. When that term is a location counter reference (*) 
or an arithmetic constant, the length attribute is 1. The value attribute of the symbol is the 
value of the expression. When the newly defined symbol is referenced in later statements, it 
has all the attributes assigned by the EQU statement. 


The EQU statement can equate symbols to register numbers, immediate data or other 
arbitrary values, as shown in the first two examples of Figure 8-1. 


The EQU statement can also equate symbols to frequently used or complex expressions, so 
that the programmer can use the symbol rather than an entire expression, as shown in the 
last two examples of Figure 8-1. Note that all symbols in the expression must be previously 
defined. 
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OPERATION OPERAND 


12 3 4 6 6 7 8[9] 10 11 1213 14 15 16 17/181 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 36 36 37 3839 40 41 42 4344 45 46 47 48 49 50 


B+25/¢C . a | 
(6848) 7M) #BS-NAR 


Figure 8-1. Examples of EQU Statements 


WDD AND BDD — WORD AND BYTE DEFINED DATA 


The WDD and BDD statements define aligned data in storage. The WDD statement aligns the 
data constant defined in the operand at word boundaries; the BDD statement aligns data at 
byte boundaries. Both statements have the same basic format: 


Operation Operand 


Any symbol WDD or BDD One or more operands 
or blank separated by commas 


The name field reflects the address after alignment. 
Operands must be separated by commas and have the format: 


a Where: 


a3] 
ou 
2) 
— 
rs¥) 
il 


A data value to be generated (required); any valid ex- 
pression. If the data value is a forward symbolic refer- 
a(b) ence, and no explicit size is coded, it is assumed to be 
a two-byte value. 


b = A length specification (in bytes); a positive predefined 
absolute expression. If omitted, the length specification 
is the implied size of the expression. If the explicit size 
of a forward symbolic reference is one byte, and if the 
symbol resolves to an arithmetic or string of more than 
one byte, a warning diagnostic is issued. 


c = A repetition factor; a positive predefined absolute ex- 
pression. If omitted, a repetition of one is assumed. 


8-2 


Bulletin: 2202.001-0101 
Date: 3/19/73 


If the length specification or the repetition factor is zero, no data is generated, but the 
location counter is aligned on the specified word or byte boundary. 


Examples of WDD and BDD statements are shown in Figure 8-2. In the last example, if M = 
N, the term 35 is generated. If M # N, no data is generated, but the location counter is set 
on a word address, which is given the name NAM4. 


OPERATION OPERAND 
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Figure 8-2. Examples of WDD and BDD Statements 


The value attribute of the symbol in the name field is the address of the leftmost byte after 
alignment. The length attribute is the length in bytes (specified or implied) of the first (or 
only) data field in the operand. 


Omitted operands, signified by a comma without a data value, indicate a zero byte or word. 
The last data value in a string of multiple operands must be a specified data value, not an 
omitted operand. 


Consider the following example. Notice that an arithmetic constant, such as 45, uses two 
bytes. 


Statement: . Generated Data 
WDD ,12,,,45 00 00 Word 1 


00 OC Word2 
00 00 Word 3 
00 00 Word 4 
00 2D Word5 


If the data value is a relocatable expression other than $SYSEG, the length specification and 
the repetition factor have the following restrictions: 


1. The length attribute must be resolved to two bytes. If the length is 
not specified, two bytes are assumed. 


2. Alignment must be on a word boundary. 


For $SYSEG, the length attribute is 1 and alignment must be on an odd boundary. 
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Literals (which are always relocatable) in a WDD or BDD statement require special 
consideration. If a literal term is used in the WDD or BDD statement, the implied length and 
repetition attributes are (2,1). If other specifications are included, they refer to the literal 
term itself, but not to the symbol defined in the name field. Consider this statement: 


OPERAND 


OPERATION 


a ee a ee ee ee ce en Sk Sees Tae Eanes Gennes By 


The length attribute of the literal C‘’ABCD’(5,2) is 10; but the length attribute of the 
symbol B1 is 2, because the operand is a relocatable term. In all other cases, the symbol in 
the name field receives the length attribute of the first data field in the operand. 


If the location counter (*) is referenced in the operand field, the value attribute of the 
symbol in the name field replaces the operand. For example, TAG WDD *,*,* generates 
three words of data, each assigned the value attribute of TAG. If TAG is equal to to 1004, 
then 1004 1004 1004 is generated. 


For example, the following statement specifies that two 8-byte fields of all zeros are to be 
generated. TAG represents the address of the first byte of generated data. 


OPERATION OPERAND : 
10 11 12 1314.15 14 15. 16 174 18] iz 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


If the location counter is pointing to OOFE, TAG is equal to OOFE and the storage locations 
are as follows. (The last byte is O10D or TAG+15.) 


<a 


Locations Contents 

OOFE 00 OO 

0100 00 OO : 

0102 00 00 First operand 
0104 00 00 

OT06 00 OO 

0108 00 OO 

010A 00 00 Second operand 
010C 00 OO 


if the location counter is pointing to an odd-byte address when a WDD statement is 
encountered, the assembler automatically updates the counter to the next word boundary 
and does not affect the contents of the odd-byte address. 


In the preceding example, if the location counter is pointing to OOFD, the assembler updates 


the counter to OOFE and the contents of OOFD are unchanged. The storage locations are as 
follows. 
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Locations Contents 


OOFC XX XX xx indicates that the contents are 
OOFE 00 O00 residual data 

0100 00 OO 

0102 00 OO 

010C 00 OO 


TAG, then is equal to OOFE. However, if TAG BDD 0(4,2), 0(4,2) is specified rather than 
TAG WDD 0(4,2),0(4,2) and the location counter points to OOFD, the first zero byte is 
stored at address OOFD and the last byte at address O10C. TAG is equal to OOFD. 


If multiple operands are specified, each operand is word-aligned for the WDD statement, or 
byte-aligned for the BDD statement, as in the example: 


Statement Generated Data 


WDD TAG1,X‘13',X‘05',TAG2 TAG1 Word 1 
13 xx Word 2 
05 xx Word3 
TAG2 Word 4 


Where: 
TAG1 = atwo-byte relocatable tag 
XX = contents are residual data 
TAG2 = atwo-byte relocatable tag 


WRS AND BRS — WORD AND BYTE RESERVE STORAGE 


The WRS and BRS statements reserve storage without preset data. The format of the WRS 
and BRS statement is: 


Operation Operand 


Any symbol WRS or BRS Absolute 
or blank arithmetic expression 


The symbol in the name field is the address of the first byte, and has the length attribute 
(number of bytes) of the storage area. 
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The operand of the WRS statement specifies the number of words to reserve; the operand of 
the BRS statement specifies the number of bytes. Symbols used in the operand field must 
be previously defined, and when evaluated must equal a positive, absolute arithmetic value. 
If the operand is zero, the location counter is aligned on the specified word or byte 
boundary. 


In the following example, WRS and BRS each reserve 800 bytes of storage. The first byte of 
the WBUFF area begins on a word boundary, while no distinction between odd or even 
address bytes is made for BBUFF. 


NAME OPERATION OPERAND 
12 3 4 5 6 7 8{9| 10 11 1213 14 15 16 17118] 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 3839 40 41 42 43.44 45 46 47 48 49 50 
2 » » 


In Figure 8-3 the example shows the use of an ORG statement in conjunction with WDD 
and BRS. After the second ORG statement, the value of TAG1(29,1) is: CONTENTS OF 
ABCD ARE INVALID. 


OPERAND 


PTs Ro ad oh) 1 ry ' 4 1 i a 1 ‘ i a 4 7 A omar Saree | 4 4 1 


. RETURNS. CTR TO. Ted 
_ INSERTS, CHAR’S. AT. TAG2 
aan nal no carne cain RICH. 


ene Sa ae ee ce © 


Figure 8-3. Example of an ORG Statement with WDD and BRS 
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FORM — DEFINE DATA FORMAT 


The FORM definition statement defines a symbolic name to be used as a mnemonic in the 
operation field of a subsequent statement, and specifies the size (in bits) and storage 
alignment of each operand to be used with the mnemonic. The format of the FORM 


definition statement is: 


One or more positive arithmetic 
expressions separated by commas 


Operation 


Ordinary 
symbol 


The name field which is required, defines the mnemonic operation code for a FORM 
instruction statement. Expressions in the operand field must equal a number between 1 and 
255. Symbols in the operand field must be previously defined. 


~ The FORM definition statement in the following example defines a mnemonic, STAR, and 
specifies that its first operand is assigned four bit positions; the second, four also; and the 
third, eight bit positions. 


NAME [ OPERATION | OPERAND 
12.3.4 5 6 7 8]9] 10 11 1213 14 15 16 17] 18] 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33.34 35 36 37 3839 40.41 42 43.44 45 46 47 48 49 50 
ance en ener ee mance 


FORM — INSTRUCTION STATEMENT 


The FORM instruction statement specifies the data to be generated according to the format 
defined by the corresponding FORM definition statement. The format of the FORM 


instruction statement is: 


Any symbol FORM name Exp,exp,. . .,exp 
or blank 


The FORM name in the operation field must be previously defined in a FORM definition 
statement. 


The operand field may contain any valid expressions, separated by commas. No alignment is 
performed before data generation. The values specified in the operand field of the FORM 
instruction are matched by position to the fields defined in the operand of the 
corresponding FORM definition statement. 


Missing operands (signified by contiguous commas) are replaced with zeros. If the number 


of operands in the instruction does not match the number specified in the definition, an 
error message is generated. 
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If the symbol in the name field of a FORM definition is a mnemonic used in more than one 
type of instruction, the assembler assigns attributes to the instruction according to the 
following hierarchy: 


1. Machine and assembler instructions. 

2. User macros and user FORM instructions within user macros. 
3: User FORM instructions outside macros. 

4. System macros and FORM instructions within system macros. 


For example, if the programmer codes the following statements, the assembler treats the 
statement &A EQU "A as an assembly language statement (1. above) rather than a FORM 
instruction. 


NAME £ OPERATION 
12.3 4 5 6 7. 8/9] 10 11 1213 14 15 16 17 


OPERAND 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


lf the value of an expression is relocatable and not $SYSEG, the following conditions must 
be met; or a relocation error occurs and the expression is made absolute: 


1. The size of the corresponding FORM definition field must be 16 bits 
in length. 
2. The field must begin on a word boundary. 


If the operands of a FORM instruction statement do not use a complete byte, the remainder 
of the byte is unchanged. For example, the FORM definition statement, SIGN FORM 1,5,3 
specifies that 9 bit positions are required for the operands. When a FORM instruction, such 
as .A1 SIGN A<EQ>B,"B,0 calls this definition, the assembler uses two full bytes, but the 
last 7 bit positions of the second byte are zeros. 


If $SYSEG is used as an operand in a FORM instruction, the size of the corresponding 
FORM definition field must be 8 bits and start on a byte boundary. 


PADDING AND TRUNCATION RULES FQR FORM STATEMENTS 


Padding and truncation is done according to the following rules: 


qs Hexadecimal values are right-justified with zero fill on the left. If the 
actual data is larger than the defined field, the data is truncated on 
the left. 
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Bulletin: 2202.001-0101 
Date: 3/19/73 


2. Alphanumeric character constants are left-justified with blank fill on 
the right. If the actual data is larger than the defined field, the data is 
truncated on the right. 


3. Packed decimal values are right-justified with zero fill on the left. If 
the actual data is larger than the defined field, the data is truncated 
on the left. 

4. Zoned decimal values are right-justified with zero fill on the left. If 
the actual data is larger than the defined field, the data is truncated 
on the left. 

5. integer string values and arithmetic values are right- justified with the 


sign propagated on the left. If the actual data is larger than the 
defined field, the data is truncated on the left and the sign is lost. 


6. Floating point values are expanded with zero fill on the right. If the 
actual data is larger than the defined field, the value is truncated on 
the right. 


The examples in Figure 8-4 illustrate certain padding and truncation rules. The first operand 
of TAB1, a hexadecimal 5 (0101), is truncated on the left and the two rightmost bits (01) 
are inserted in the 2-bit field defined by 2 in the FORM definition statement. If the value 
attribute of B in the second operand is less than C, the single bit position established in the 
corresponding definition statement is set to a binary 1. If B is greater than C, the bit is set to 
a binary 0. 


The first A character constant (1100 0001 in EBCDIC) in the second TABLE statement is 
truncated on the right, and the remaining two leftmost bits (11) are assigned to location 
TAB2. Note, however, that all eight bits (1100 0001) of the second A character constant in 
the fourth operand position are retained at location TAB2+1. 


OPERAND 


| Bel S B16 8, 
"&, beirSc, Ast, “FQ, ADDR, BYTE... 
“ C' A‘. 1p CA. pec a Ba ar a a a ig nd 


Figure 8-4, Examples of Padding and Truncation for Form Statements 


The following examples show a possible. use of the FORM statement — redefining 
instructions to create a new language closer to English. In the first example, the “MOVE” 
instruction generates a MOVM machine instruction, using a FORM statement and a series of 
Equates. This corresponds to: MOVM BUFFERB(R2),@BUFFERA(R3). Assuming that 
BUFFERA is at address 63FA, the code generated is: 


602B 
63FA 


63FC 
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; OPERATION ca 


OPERAND 
1-234 6 6.7 8} 9| 10 11 1213 14 1 14 16 16 17] 13] 19 202: 21 22 23 24 25 | 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44.45 46 47 48 49 50 


+ ape area eres chi al fetes ames Baber Eee apiney Weigle nia Coe sem ed 

| oes + Fie eet cee 1 iene eres Bo feat, al Me ee. 
kk et 

fares ro ha ee Be ek tH ed ed 


a ae eee CE Cee Eee roe! Dekcoeed (ama Cen! Race UE) Cores (omen Cae CeO 9 


X'6 
B,1.,3,1.,3,. é a 6 ed Se et 
C.!. (2)... Poe SADR VENT RE Ce (CEES SOR Veen SRN OOTY COW Crea) POEPy SRO! Tene Geese TONS AA 
C ’ t 
B 


sty Sreeete | 
UFFERB,BUFFERA............. 


a ree CE Re, SEEDY SOS SOOORE ESTE EOS Scons UOnteOeS ORRRENY FORT NEES CE WEEEEL SEnOeRDy COSY Corny od 


Clog 
R2, INDIRECT, R35 7 


The next example shows a BRANCH FORM statement used alone to generate a BR machine 
instruction, or together with ROUTINE to generate a BSR machine instruction. Assuming 
that SUBROUT‘1 is at 2F3A, the code generated is: 
EAQ7 
2F3A 


The last statement of this example, BRANCH REGISTER,R7, generates the code: EBO7. 


OPERATION OPERAND 


5: aeons nee SF ee See ae ered eee Ge tee ee be ciel ae ee a a a cane! Aa pene ween 5 

i BS ae od I OD, 38 A) AS Oe A, te Sa) el ee boa 1 « ee nee One 9 Foe Sane Sars Ones Ea 
rr a re oe Se | L doo eB. a de 

‘ a we De ee tl here merle corer ade 


a a oe a an ey es a See Lae ees BAN POE Bs 


AVERTN,R ee ee ate ee 
AVERTNR7 ioihied 


en Se eceees Senet Gnenee EanOND a oe Sori od 


rics eee Re PCLT RHE Ee 


A detailed example of the FORM instruction can be found in Appendix F. 
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9. LISTING CONTROL STATEMENTS 


The listing control statements control the printing of the lines of code generated by the 
assembler. The statements themselves are used only for the source listing and are not carried 
over to the object program. 
The assembler mnemonics and functions of the listing control statements are: 

TITLE — Identifies the listing. 

EJECT Starts a new page. 

SPACE _ Inserts blank lines. 


PRINT Specifies the details to be printed. 


TITLE, SPACE, and EJECT statements do not appear in the source listing. 


TITLE — IDENTIFY LISTING 


The TITLE statement specifies the program |D and the heading to be printed on each page 
of the listing. The format of the TITLE statement is: 


Character string constant 


The first symbol (except a sequence symbol) in the name field of any TITLE statement is 
printed in the program ID area at the top of each page of the entire listing. The name field 
of all other TITLE statements must contain a sequence symbol or a blank. 


Operation 


Symbol 
or blank 


The character string in the operand field specifies the heading for each page. Any variable 
symbols in the character string are resolved. The resolved character string must not be more 
than 90 characters. 


When the TITLE statement appears in a source program, the assembler ejects the current 
page and prints the specified title on the top of the next page. This title is printed on the 
top of each page until another TITLE statement appears. 


In the following example, PGM1 and FIRST SUBROUTINE is printed on all sheets of the 
listing until another TITLE statement appears: 
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OPERAND 


: NAME OPERATION 
1234 6 6 7 819/10 11 1213 14 15 16 17 


Assume that this heading has been printed on six sheets, and the following TITLE statement 
is encountered while the sixth sheet is being printed. 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 36 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 
C'FIRST. SUBROUTINE’ 
BO Ok ae BP chim GRY pity St Gag WE eel el ST ge aie 4 ee ca a ee 


DPSisihcka dad Se a hick hee 


OPERAND 


The assembler halts the printing and ejects the sixth sheet. The new heading, SECOND 
SUBROUTINE, is printed on the seventh sheet. Printing then continues with the seventh 
sheet. Note that a sequence symbol in the name field does not change the program ID. 


EJECT — START NEW PAGE 


The EJECT statement ejects the remainder of the page and resumes the printing at the top 
of the next page. The format of the EJECT statement is: 


Operation Operand 


Sequence Not used — ignored by the 
symbol or assembler 
blank 


The EJECT statement can be used to separate routines in a program listing. Two successive 
EJECT statements leave the remainder of the current sheet plus the entire next sheet blank. 
A TITLE statement immediately followed by an EJECT statement produces a page that is 
blank except for the heading specified in the TITLE statement. 


SPACE — INSERT BLANK LINES 


The SPACE statement inserts one or more blank lines in a listing. The format of the SPACE 
statement Is: 


Operation Operand 


Sequence Absolute 
symbol arithmetic expression 
or blank 


The assembler evaluates the expression in the operand field to determine the number of 
lines to leave blank. Symbols in the expression must be previously defined. If the number of 
lines to be left blank exceeds the number left on the current page, the SPACE statement 
functions as an EJECT statement, and the next line is printed on the top of the next page. 
An example of a SPACE statement is: 


NAME i OPERATION 
12.3 4 5 67, 8{9] 10 11 1213 14 15 16 17/19 


OPERAND 


Xe ~B)#S +1. eee a ee 


a ee ee ee ee en ee es Ce ce ene Fy 


PRINT — PRINT OPTIONAL DATA 


The PRINT statement controls the extent of the printing. The PRINT statement cannot 
appear within a macro. The format of the PRINT statement is: 


Sequence One to four operands 
symbol separated by commas 
or blank 


The operands, which may appear in any order, specify the amount of data to be printed. 
The two choices for each operand are: 


1. ON A listing is printed. 
OFF No listing is printed. 
2. GEN All statements generated from a macro instruction 
are printed. 


NOGEN Only the macro instruction is printed. 


3. DATA Generated data is printed in full. 
NODATA Only the leftmost eight bytes of generated data are 
printed. 


4. COND Conditional statements are printed. 
NOCOND = Conditional statements are not printed. 


The operand cannot contain a variable symbol. Each condition specified by the operands 
remains in force until it is changed by another PRINT statement. A program can contain 
any number of PRINT statements. If a PRINT statement does not appear ina program, or 
until it does appear, the assembler assumes the following conditions: PRINT 
ON,NODATA,GEN,NOCOND. 


For example, the following statement requests the assembler to assemble 256 bytes of 
zeros: 


OPERAND 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47.48 49 50 


L 
A 4.25.6), gi ge ag re a ie 


(ecu waa lence 8 oe A i ee ck ee ee ces a es ei i 


If the operand DATA is included in the last PRINT statement, the listing contains all 256 
bytes of zeros. If the last PRINT statement included the operand NODATA, only eight 
bytes of zeros are listed. 


If the operands of a PRINT statement are contradictory (such as OFF and DATA), the 
assembler determines the printing according to the following priority: 


1. ON or OFF 
2: GEN or NOGEN 
3. DATA or NODATA, and COND or NOCOND 


When NOCOND is specified, conditional statements with errors are printed unless OFF is in 
force, or the statement occurs in a macro when NOGEN is in force. 


Note that the line numbers generated will not be in sequence when NOGEN or NOCOND is 
specified. Jumps in the line numbers indicate that statements were not listed due to NOGEN 
or NOCOND. However, if the suppressed statements contain errors, the error messages still 
refer to lines which do not appear in the listing. 


10. MACRO LANGUAGE AND CONDITIONAL 
ASSEMBLY STATEMENTS 


The macro language and conditional assembly statements are so closely related that it is 
difficult to explain either concept by itself. Thus, this section is divided into two 
subsections. The first explains the basic structure and application of the macro language. 
Sufficient information is supplied to write a simple macro definition and instruction. The 
second subsection deals with specific conditional assembly statements and their use within 
more complex macros and assemblies. 


MACRO LANGUAGE 


The macro language provides a convenient way to generate a desired sequence of assembler 
statements many times in one or more programs. The principal features are the macro 
definition and the macro instruction. The macro definition is a composite piece of coding 
which serves as a prototype for generating source statements. The macro instruction is a 
single statement which calls the macro definition for assembly and assigns values to the 
variable symbols in the macro definition. 


The macro definition is written only once; the macro instruction is written each time a 
programmer wants to generate the desired sequence of statements. This facility can help 
simplify the coding of a program and reduce the chance of coding errors. 


Macro definitions must appear in a source program before all PUNCH statements and 
statements pertaining to the first control section; consequently, only EJECT, PRINT, 
SPACE, TITLE, ICTL, ISEQ, and comment statements can validly precede the first macro 
definition. All of these statements except ICTL can appear between macro definitions. 

A macro definition cannot appear within a macro definition; however, one macro can call 
another macro. 


MACRO DEFINITION 


A macro definition has four parts: 


1. Header statement 

2. Prototype statement 
3: Model statements 

4. Termination statement 
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HEADER STATEMENT 


The header statement identifies the beginning of a macro definition. It must be the first 
statement of a macro definition. The format of the header statement is: 


Blank Blank — ignored by the assembler 


PROTOTYPE STATEMENT 


The prototype statement specifies the mnemonic operation code and the format of macro 
instructions that call the macro definition. The prototype statement must be the second 
statement of every macro definition. The format of the prototype statement is: 


Operation Operand 


Symbolic Mnemonic 0 — 35 symbolic parameters 
parameter operation 
or blank code 


The name field may be blank, or it may contain a symbolic parameter. 


The mnemonic operation code in the operation field is the macro name used to call the 
macro definition for assembly. This code must not be used in another macro definition, nor 
can it be a recognized mnemonic of a machine or assembler instruction. 


The operand field may contain O through 35 symbolic parameters, separated by commas. 
The first four characters of a symbolic parameter should not be &SYS. Comments can 
appear only if symbolic parameters are present. 


The symbolic parameters in the name field and the operand field represent variable values 
that are supplied by the programmer when he calls the macro for assembly. Subsequent 
model statements use these symbolic parameters. 


The operands in a prototype statement can be positional or keyword. Keyword and 
positional operands cannot both be used in the same prototype statement. 


Positional operands require that the operands of a macro instruction be written in the same 
order as the corresponding symbolic parameters of the prototype statement. Positional 
operands cannot have a default value and must begin with an ampersand (&) followed by 
one to seven alphanumeric characters, the first of which must be alphabetic. Examples of 
positional operands are &PAR1, &P, &P2. 
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Keyword operands may appear in any order in the macro definition and the macro 
instruction, because the parameters are recognized by the keyword, not by the order or 
position of the symbolic parameter in the prototype statement. Keyword operands may be 
assigned default values. A default value must be a standard value, not a variable symbol. 
Keyword operands are similar to positional operands, except that keyword operands are 
immediately followed by an equal sign and optionally followed by a standard value. If a 
value is not assigned, the default value is null. Examples of keyword operands are: 
&PAM1=22,&P=C’ABCD’, &PAM3=. 


The length of a prototype statement can be any number of lines. Continued lines must end 
with a semicolon. A semicolon may not be the first character of a continuation line. 


MODEL STATEMENTS 


Model statements are the macro definition statements from which the assembler language 
statements are generated. Zero or more model statements may follow the prototype 
statement. In the use of special characters, model statements must follow the same rules as 
macro instruction operands. The rules pertaining to special characters in macro instructions 
are discussed under Special Characters in a Macro Instruction \ater in this chapter. Model 
statements must also follow the normal continuation line rules, and statements generated 
from model statements must not require more than 160 characters. Only generated 
statements appear in the listing. The format of the model statement is: 


Any symbol Instruction or Any symbols or terms 
or blank variable symbol 


The name field may be blank, or may contain a symbol. Because a sequence symbol inside a 
macro definition is local to that definition, the same sequence symbol can be used in 
another macro or outside the macro definition. However, within the same macro definition, 
a sequence symbol can be generated only once. Thus, a sequence symbol may be used in 
more than one model statement, provided that the statements which duplicate it are skipped 
due to conditional assembly. Note that because prototype statements are not generated, the 
symbol in the name field of a prototype statement can be duplicated and generated in a 
model statement. The characters * and . * or a sequence symbol cannot be substituted for a 
variable symbol in the begin position of a model statement. If the model statement is an 
inner macro instruction, the name field must follow the rules for macro instructions. 


A variable symbol can be concatenated with other characters in the name field. 


The operation field may contain a machine instruction, an assembler instruction, a macro 
instruction, a form instruction, or a variable symbol. However, the following assembler 
instruction mnemonics cannot be used in the operation field of a model statement: 
MACRO, PRINT, ISEQ, ICTL, and END. Variable symbols cannot be used to generate an 
ADO, AGO, ANOP, SETA, SETC, PUNCH, MEXIT, GBLA, GBLC, MNOTE, CSECT, COM, 
MACRO, SEG, PRINT, ISEQO, ICTL, or END mnemonic, or macro instruction mnemonic 
operation codes. 
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The operand field may contain ordinary, variable, or sequence symbols, or other terms, 
depending upon the instruction in the operation field. A symbolic parameter in the operand 
field of a model statement must first be defined in the prototype statement. Comments can 
appear after the last operand. No substitution is made for variable symbols in a comment. 


A model statement may be a comment statement. An asterisk in the begin column indicates 
that the entire line is a comment statement. The assembler converts a model comment 
statement into an assembler language comment statement. 


The programmer may also write comment statements in a macro definition which are not to 
be generated. These statements must have a period in the begin column, immediately 
followed by an asterisk and the comment (.*comment). 


The line following a PUNCH model statement is the only exception to model statement 
format rules. Format rules do not apply because the line contains output data, and all 
characters between the begin and end positions are in free format. Substitution is performed 
for all variable symbols between the begin and end positions. 


Relationship of Model and Prototype Statements: Figure 10-1 illustrates the relationship 
between model statements and the prototype statement. Notice that the symbolic 
parameters &TAG1, &TAG2, &TAG3S, and &TAG4 are defined in the prototype statement 
before they are used in the model statements. 


OPERATION OPERAND 


a PO 


Figure 10-1. Macro Definition 
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TERMINATION STATEMENT 


The termination statement specifies the end of a macro definition. It can appear only once 
within a macro definition and must be the last statement of the definition. The format of 


the termination statement is: 


Sequence Blank — ignored by the assembler 


symbol or 
blank 


MACRO INSTRUCTION 
The macro instruction performs the following functions: 
1. Calls the macro definition fi assembly. 
2. Assigns values to the symbolic parameters in the macro definition. 


The macro instruction closely parallels the prototype statement. The values in the macro 
instruction are equated to the symbolic parameters in the prototype statement. The format 


of the macro instruction is: 


Ordinary Mnemonic 0 — 35 operands 


symbol, operation 
sequence code 
symbol, 

or blank 


The name field may be blank, or it may contain an ordinary symbol or a sequence symbol. 
An ordinary symbol is defined in the assembly only if a symbolic parameter is both in the 
name field of the prototype statement and in the name field of a model statement. If the 
model statement which has the symbolic parameter in its name field is skipped as a result of 
conditional assembly, the statement is not generated. Consequently, the ordinary symbol in 
the name field of the macro instruction is also not generated. 
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A sequence symbol in the name field of the macro instruction is never carried over to the 
name field of the generated model statement. This sequence symbol can only be used in the 
operand field of an AGO statement — never as the second operand of an ADO statement. 


The mnemonic operation code in the operand field must be previously defined in a macro 
definition or in the system macro library. 


The number of operands in the operand field may not exceed the number of operands in the 
prototype statement. An operand can have up to 127 characters. 


POSITIONAL OPERANDS 


If the prototype statement has positional operands, the operands of the macro instruction 
correspond to the symbolic parameters in the prototype statement, and the operand values 
are applied to the symbolic parameters in sequence. If the macro instruction has fewer 
operands than the prototype statement, the unmatched symbolic parameters in the 
prototype are assigned null values, not blanks. Two contiguous commas in the operand field 
indicate an omitted operand, which is also assigned a null value. The examples in Figure 
10-2 illustrate positional operands. 


Prototype: &LABEL POS &TAB1,&TAB2,&TAB3 Values: &TAB1 = 42 

Instruction: .FIRST POS 42,15,63 &TAB2 = 15 
&TAB3 = 63 

Instruction: SEC POS 16,,2 Values: &TAB1 = 16 
&TAB2 = null 
&TAB3 = 2 


Figure 10-2. Macro Instruction — Positional Operands 


KEYWORD OPERANDS 


If the prototype statement has keyword operands, the macro instruction must also have 
keyword operands. The instruction keyword, which is all characters before the equal sign, 
must directly match the keyword in the prototype operand, except that the instruction 
keyword operand is not preceded by an ampersand. The value following the equal sign in 
the macro instruction is assigned to its corresponding symbolic parameter. Symbolic 
parameters not matched by a macro instruction operand retain their default value. The 
examples in Figure 10-3 illustrate keyword operands. 
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Prototype: &LBL KEY &PARM1=5,&PARM2=,&PARM3=C’VALUE’ _— Values: +=&PARM1 = 100 
Instruction: .THD KEY PARM3=C’PRICE’ PARM1=100 &PARM2 = null 
| &PARM3 = C’PRICE’ 
Instruction: .FOUR KEY PARM1=ABCD,PARM2="7B Values: &PARM1 = ABCD 
&PARM2 = "7B 


&PARM3 = C’VALUE’ 


Figure 10-3. Macro Instruction — Keyword Operands 


SPECIAL CHARACTERS IN A MACRO INSTRUCTION 


A macro instruction operand may consist of any combination of up to 127 characters, 
provided the syntactical rules for the following special characters are observed. These 
characters have special meanings in a macro instruction operand. 


r escape character (#) e comma 

& ampersand e semicolon 
@ apostrophe e blank 

° parentheses 


Escape Character 


The first character after an escape character retains its literal value. Therefore, if a special 
character is to retain its literal value, it must be preceded by an escape character. For 
example, the following operand field has three operands: 

#(C#.B, #,#, XYZ 

tenn amet 


1 2 3 
Escape characters are part of the operand value and are carried over to the model statements. 


Ampersand 

An ampersand followed by a letter indicates the start of a variable symbol. During assembly, 
the current value is substituted for all variable symbols found in a macro instruction. In the 
following example, only &V1 is substituted. 


C’ARV 1#F&V2',C’#&V3 #&V4' ABTX’RV1 
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Apostrophe 


An apostrophe immediately preceded by the letter C signifies the start of a character string 
constant. The character string constant extends to the next apostrophe. Parentheses, 
commas, and blanks lose their special meanings when they are enclosed in a character string 
constant, as in the example: 


C’A,BC( 539’ 


The comma, blanks, and left parenthesis are part of the character string constant. In any 
other context, the apostrophe retains its literal value. 


Parentheses 


An operand beginning with a left parenthesis and ending with a right parenthesis signifies an 
operand sublist. Within a sublist, the comma is a suboperand separator, not an operand 
separator. Special characters, other than the comma, retain their special meanings within a 
sublist. Parentheses that do not specify an operand sublist retain their literal value. 
Examples of operands with parentheses are: 


A,(B,C) Two operands: [A] [(B,C)] 


A(B,C) One operand — operand does not begin with a left 
parenthesis 


(A+B)/2(R,4) One operand — operand does not begin and end 
with matching parentheses 


Comma 


The comma separates operands or suboperands, unless the comma is inside a character string 
constant, preceded by an escape character, or follows a left parenthesis that is not the 
opening parenthesis of a sublist. In these three cases, the comma retains its literal value. 
Examples of operands with commas are: 


A,B,C Three operands: [A ] [B ] [C] 

A#,B#,C One operand: comma preceded by # 

B(C,4+K One operand: comma preceded by ( 
Semicolon 


The semicolon indicates line continuation. Characters following a semicolon are considered 
comments. The semicolon cannot be the first character of a continuation line. The current 
line continues with the first nonblank character of the next line, as in the following 
example: 
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A,BHCD,52,;HERE HERE is a comment. The four operands are: 
CON [A ] [BHCD ] [52 ] and [CON]. 


Blank 


A biank signifies the end of the operand field. Characters following a blank are considered 
comments. 


SUBLISTS IN MACRO INSTRUCTIONS 


To group a number of suboperands as a single symbolic parameter value, the macro 
instruction operand is. written as a sublist. A sublist consists of one or more suboperands 
separated by commas and enclosed in parentheses. Each suboperand has form identical to an 
operand. The entire sublist including the parentheses is considered one macro instruction 
operand. 


Omitted suboperands have a null value. However, the operand () is considered a character 
string, not a sublist with all the suboperands omitted. The operand limit of 127 characters 
applies to the entire sublist. Examples of valid sublists are: 


(A,2,4,16) Four suboperands 


(A+40,B(2,6),(N,M),240/C+X) Four suboperands 


SUBLISTS IN MODEL STATEMENTS 


In a macro instruction operand, a sublist can assign a set of values to a single symbolic 
parameter of the macro definition. Any model statement may reference the entire symbolic 
parameter, but only a SETA, SETC, or ADO statement can reference the suboperands of the 
symbolic parameter. 


The format used to reference a suboperand is: symbolic parameter (n). 
The subscript n is an arithmetic set expression that refers to the position of the suboperand 
being referenced. For example, &LIST(2) references the second suboperand of the symbolic 


parameter, &LIST. 


If the sublist (A,,C20,'192’,(N,M)) is a macro instruction operand corresponding to the 
symbolic parameter &FIEL D, the values assigned to the suboperands are: 


FIEL D(O) = null 
FIELD(1)=A 
FIELD(2) = null 


FIELD(3) = C20 
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FIEL D(4) = ’192’ 

FIELD(5) = (N,M) 

FIELD(6) through FIELD(n) = null 
A subscripted reference to an omitted sublist element, such as FIELD(2) above, is assigned a 
null value. If the macro instruction operand is a simple operand, rather than a sublist, the 
macro instruction can refer to the operand value by the symbolic parameter without a 
subscript, or by the symbolic parameter with a subscript of 1. All other subscripted 
references have a null value. 
Suboperands of sublists within a sublist (for example, N in FIELD(5) above) cannot be 
referenced in a model statement. 
SUBSTRING NOTATION 
Substring notation allows the programmer to reference part of a macro instruction operand, 
a SET symbol, or a character string constant. Substring notation consists of a variable 
symbol or a character string constant, immediately followed by two arithmetic set 
expressions separated by a comma and enclosed in parentheses, as in the examples: 

&NAME(2,4) 

C’AB24CFG‘(&P1,2) 
The first expression indicates the position of the first character to be included in the 
substring. The second expression indicates the number of consecutive characters (beginning 
with the character indicated by the first expression) to be included in the substring. 
if the substring specifies more characters than are in the macro instruction operand or in the 
character string constant, only the number of available characters are supplied. If the 
starting character is outside the range of the string, a null character is supplied. 


Substring notation has the following limitations: 


1 Substrings can only be specified for character string constants, macro 
instruction operands, and SET symbols. 


2. A substring of a sublist cannot be specified. 


3. A substring reference can only be used as a term in a conditional 
assembly statement. 


Consider the example in Figure 10-4. 
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Prototype: &LABEL WRITE &P1,&P2,&P3 Values: &P1 = 24 


Instruction: .FIRST WRITE 24,C‘ABCDE',734A &P2(3,3) = ABC 


&P3(1,2) = 73 


Figure 10-4. Examples of Substring Notation 


CONCATENATION OF VARIABLE SYMBOLS 


Variable symbols in model statements can be concatenated so that the name field, operation 
field, or operand field can be modified by a macro instruction. Thus, the mnemonic 
instruction DIV can become DIVA, DIVB, or DIVC, and the operand FIELD can become 
FIELDA, FIELDB, or FIELDC. 


The example in Figure 10-5 illustrates concatenated operation codes and operands in a 
macro definition. 


NAME OPERATION OPERAND 


12.3.4 5 6 7, 8{9| 10 11 1213 14 16 16 17} 18] 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 3839 40.41 42 43.44 45 46 47 48 49 50 
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- Figure 10-5. Concatenation of Variable Symbols 
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NESTING OF MACROS 


A model statement in a macro definition may be a macro instruction that calls another 
macro. Model statements used as macro instructions are called inner macro instructions. 
Macro instructions not used as model statements are called outer macro instructions. 


Rules for inner macro instructions are the same as for outer macro instructions. Symbolic 
parameters in an inner macro instruction are replaced by the corresponding characters of the 
outer macro instructions. Sublists of an outer macro instruction cannot be passed as a 
sublist to an inner macro instruction. 


An outer macro instruction is a first level macro instruction. The first inner macro 
instruction is a second level instruction, the second inner macro instruction is a third level, 
and so on. Five levels of macro instructions are allowed. Within each level, any number of 
macro instructions may be used. 


Figure 10-6 demonstrates the inner and outer macro instructions and the various levels of 
instructions. 


Source 
Program 
MACRO MACRO MACRO 
READ COMPUTE DIVIDE 
Model Model Model 
READ Model Model Model 
A COMPUTE Model Model 
Model DIVIDE MEND 
Model * Model Ss 
END Model iY MEND * . 
\ MEND x Ne 
\ . AN 
\ \ \ 
— — Outer macro ———— Inner macro — — — «Inner macro 
instruction instruction instruction 
(first level) (second level) (third level) 


Figure 10-6. Nesting of Macros 


MNOTE — GENERATE ERROR MESSAGE 


The MNOTE statement is used only in a macro definition to generate an error message. The 
format of the MNOTE statement is: 


Operation 


Operand 


Sequence 
symbol or 
blank 


Severity code, message or 
message only 
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The severity code may be W — warning error, or F — fatal error. If the first character is not a 
W or an F followed by a comma, the statement is treated as a warning error. 


The message may be any EBCDIC characters. The line may not be continued, and no 
substitution is performed. Examples of MNOTE statements are: 


Statement Generated Message 
MNOTE W,message W MNOTE *message* 
MNOTE F,message F MNOTE *message* 
MNOTE Fmessage W MNOTE *Fmessage* 
MNOTE message W MNOTE *message* 


MEXIT — ALTERNATE TERMINATION FOR MACRO DEFINITION 


The MEXIT statement indicates an alternate termination point for a macro definition. The 
format of the MEXIT statement is: 


Sequence Blank — ignored by the assembler 
symbol or 
blank 


When an MEXIT statement is processed, the next statement processed by the assembler is 
the statement immediately following the macro instruction that called the macro. If MEXIT 
is skipped due to conditional assembly, MEXIT is ignored. The MEXIT statement cannot 
replace MEND as the final statement of a macro definition. 


SYSTEM VARIABLE SYMBOLS — &SYSNDX AND &SYSECT 


The system variable symbols, &SYSNDX and &SYSECT, are automatically assigned values 
by the assembler. These symbols can be used only in the name, operation, and operand 
fields of statements in macro definitions. They may not be defined as symbolic parameters, 
nor can they be assigned values by SET statements. 


&SYSNDX 
Assigned an original value of 0001 for the first macro instruction processed, &SYSNDX is 
increased by 1 for each inner or outer macro that is processed. Thus, the value of 


&SYSNDX represents the current number of macro calls processed up to and including the 
current call. 
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The value of &SYSNDX always remains constant within a macro level, regardless of how 
many inner macros are called. When the assembler returns to a given macro (from an inner 
macro), the value of &SYSNDX in effect is the value it had when the macro was first called. 


Figure 10-7 illustrates the changing value of &SYSNDX. The numbers to the left of the 
model statements indicate the value of &SYSNDX as each statement is processed. 


The variable symbol! &SYSNDX can be concatenated with other characters to form unique 
names in statements generated from the same model statements. Thus duplicate names can 
be avoided when a macro is called more than once. 


&SYSNDX as an arithmetic term in a SETA expression produces an arithmetic value. In 
other contexts, the value of &SYSNDxX is a four digit number, including leading zeros. 


The example in Figure 10-8 shows how &SYSNDX can be used. All statements in the 
example are part of the same macro, which is called by the eighth macro instruction 
processed during the assembly. 


Source 
Program 
MACRO MACRO 
READ COMPUTE 
Modet 2 Model 
Mode! 2 Model 
1 Model 2 Model 
COMPUTE «——————————._ MEND 
1 Model 
READ 1 Model 
1 WRITE ——-—————~** MACRO 
1 Model WRITE 
1 Model 3 Model 
1 Model 3 Model 
MEND 3 Model 
END MEND 


The numbers to the left of the statements indicate the value of &SYSNDX at that particular 
point in the program. 


Figure 10-7. Using &SYSNDX with Inner and Outer Macros 


Model Statements: 


&SET1 SETA &SYSNDX+10 Values: &SYSNDX+10 = 8 + 10 = 18 (in the SETA statement) 
&SET2 SETC &SYSNDX &SYSNDX = 0008 (in the SETC statement) 
L&SYSNDX FORM 2,6 L&SYSNDX = L0008 (in the concatenated symbol) 


Figure 10-8. Examples of &SYSNDX 
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&SYSECT 


The variable symbol &SYSECT represents the name of the control section in which a macro 
instruction appears. The value assigned to &SYSECT is the name of the last CSECT or COM 
statement that precedes the current macro instruction. If no CSECT or COM statement 
appears before the macro instruction, &SYSECT has the value of two blanks. 


In any given macro definition, the value of &SYSECT is constant, that is, the name of the 
last CSECT or COM statement before the macro instruction. During nested macro calls, 
&SYSECT in an inner model statement refers to the last active CSECT or COM statement in 
the next outer macro definition. Note the value of &SYSECT in Figure 10-9. 


Source Program 
FIRST COM MACRO MACRO 
eee READ ~~ SCRIP 
| Model THRD COM 
eee Model Model 
READ SCND COM &SYSECT CSECT 
a ae SCRIP | Model 
&SYSECT csecT i 
Os Model MEND 
! 
| 
I 


Model 


END MEND l 


| 
Value of &SYSECT is FIRST. Value of &SYSECT is SCND. 


Figure 10-9. Example of &SYSECT 


CONDITIONAL ASSEMBLY STATEMENTS 


Conditional assembly allows the programmer to specify assembler language statements 
which may or may not be assembled, depending upon conditions evaluated at assembly 
time. These conditions are usually tests of values, which may be defined, set, changed, or 
tested during assembly. Thus, different sequences of statements can be generated from the 
same macro definition. 


Almost all conditional assembly statements can be used inside or outside macros, although 
their primary use is inside macros. The macro language itself can be considered a type of 
conditional assembly. 


The conditional assembly statements are: 


SETA Assigns arithmetic values to set symbols. 
SETC Assigns character values to set symbols. 
GBLA Defines a SETA statement as global. 
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GBLC Defines a SETC statement as global. 
ADO Sets up a source statement generation loop. 


AGO Specifies a branch to another statement; skipped statements 
are not assembled. 


ANOP Specifies an assembly no-operation statement. 


SET STATEMENTS 


The SET statements assign arithmetic and character values to set symbols which can then be 
referenced in subsequent source statements. When the defined symbol appears in a 
subsequent statement, the assembler replaces the symbol with the assigned value. 


If two SET statements assign different values to the same set symbol, the last value assigned 
to the symbol is the value currently in effect. 


SET statements can appear within or outside a macro definition; however, a set symbol 
defined within a macro is local to that macro unless it is specifically declared global. 


A set symbol defined outside a macro can be referenced for its assigned value from 
anywhere in the source program. The same variable symbol may not be used as a symbolic 
parameter and as a set symbol within the same macro definition; nor can the same variable 
symbol be used in a SETA and a SETC statement, if the symbols are defined within the 
same scope. 


SETA — ASSIGN ARITHMETIC VALUE TO SET SYMBOL 


The SETA statement assigns arithmetic values to set symbols. The format of the SETA 
statement is: 


Operand 


Operation 


Set symbol SETA Arithmetic set expression 


The set symbol in the name field may not be generated as a result of substitution, that is, 
the name field must be explicitly coded. 


The expression in the operand field is evaluated as a 16-bit arithmetic value which is 
assigned to the set symbol in the name field. 
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An arithmetic set expression may consist of one term or an arithmetic combination of 
terms. The procedure used to evaluate an arithmetic set expression is the same as that used 
to evaluate arithmetic expressions in assembler language statements. The only difference 
between the two expressions lies in the terms that are allowed. The terms that may be used 
in an arithmetic set expression are: 


Arithmetic Terms Example 
Arithmetic constants 2463 or ‘‘FOF2 
SETA symbols &S1 
&SYSN DX references &SYSNDX 
Count attribute references K’&P 1 
Number attribute references N’&P2 

Character Terms Example 


Symbolic parameters, including 
sublist and substring 


references &P3(&P1) 
SETC symbols, including 

substring references &S 
Substrings of character constants C’ABCDE'(2,3) 
&SYSECT references &SYSECT 
Character constants C’ABC’ 


Any character term except a character constant may appear as a single term, or be used as 
an operand in arithmetic and logical operations, provided the resultant character string 
contains only numeric characters. When used in this context, the value of the character 
string, that is, its decimal equivalent, may not exceed 65,535. 


Any character term may be used as an operand in a relational operation. In this context, the 
term is always treated as a character constant, even if it consists solely of numeric 
characters. 


Since conditional assembly statements represent the tools for source statement generation, 
they cannot themselves be the object of substitution, nor may they be concatenated. For 
example, if the character constant C’&P1’ appears as a term in an arithmetic set expression, 
its value is &P1 regardless of the actual value of &P1. 
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The following are examples of va/id SETA statements if &P1 and &P2 are symbolic 
parameters with values (64,4,ABC) and AB246C, respectively. 


&S1 SETA 8 

&S2 SETA “AA 

&S3 SETA &S1+&S2 

&S4 SETA &P 1(1)+&P2(&P 1 (2) ,2) 

&S5 SETA (&P1(3) <EQ>C‘ABCDE'(1,3)+&P2(4,1))/2 
&S6 SETA &P2(3,3) <EQ>C’246’+N‘&P 1 


Examples of invalid arithmetic set expressions are: 


A+2 Reference to ordinary symbol 
=C’AB’ Literal term 
2+L’BETA Length attribute reference 


&P1(1)<EQ>64 &P1(1) is considered a character string, the second 
operand in the relation must be coded as a character 
term, that is, C’64’ 


P’-240' String constant other than a character constant 
C’ABC’ Character constant not used in a relation 
&P1&P2 Concatenation of symbols 


SETC — ASSIGN CHARACTER VALUE TO SET SYMBOL 


The SETC statement assigns a character value to a set symbol. The assigned character value 
can be passed with the set symbol to another statement operand. The format of the SETC 


statement is: 
Character term or 
arithmetic set expression 


The set symbol in the name field may not be generated as a result of substitution, that is, 
the name field must be explicitly coded. 


Set Symbol 
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The operand field may contain an arithmetic set expression or one of the following 
~ character terms: 


Term Example 
Symbolic parameter, including sublist &PARM2(3) 
and substring references 

SETC symbol, including substring &SET1 
references 

Substring of a character constant C’ABCDE’(2,3) 
&SYSECT reference &SYSECT 
Character constant C’ABCD’ 
&SYSNDX reference &SYSNDX 


Only one operand is allowed. The maximum size of an assigned character value is 16 bytes. 
If a larger value appears, only the leftmost 16 bytes are assigned by the assembler. 


When &SYSNDX is used as a single character term, the value is a string of four characters, 
including leading zeros. If the operand specified is an arithmetic set expression, the 
arithmetic value is converted to a 16-bit constant. 


Examples of va/id SETC operands are: 


C’24BK’ 

&P 1 

&P 1(2,4) 

&P 1 (&P2(2,1)) 

&SETC 

&SYSECT 

&SYSNDX 

(&SYSNDX+10-&P 1 (2,4)/2)* &P2(2) <EQ>C’FID’ 


Examples of invalid SETC operands are: 


X'124' String constant other than a character constant 
C’AB2’+4 Character constant used as arithmetic operand 
ALPHA Ordinary symbol 

L’ALPHA Length attribute 
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GBLA AND GBLC — GLOBAL ARITHMETIC AND CHARACTER SET SYMBOLS 


Local set symbols are made global (available outside the macro) by a GBLA or GBLC 
statement. The format of the GBLA or GBLC statement is: 


Name Operation Operand 
Blank GBLA and 1-35 set symbols, 
GBLC separated by commas 


Global statements must appear immediately after a prototype statement or after another 
global statement. Any number of continuation lines may be used. 


When a set symbol is declared global, its assigned value is available to statements in the main 
program, but not to other macro definitions. To be available to other macro definitions, the 
set symbols must also be declared global in those macro definitions. 


If set symbols have not been assigned values outside this macro definition or by a previous 
call to this definition, the global statement assigns an initial value of O to SETA symbols and 
a null character value to SETC symbols. If the set symbols have an assigned value, the global 
statements do not affect the value of the set symbols. 


ADO — ITERATIVE RETURN 


The ADO statement sets up a loop between the ADO statement and a subsequent statement 
identified in the ADO statement. The format of the ADO statement is: 


Operation 


Sequence ADO 


Operand 


Positive arithmetic set 
expression, sequence symbol 


symbol, set 
symbol, or 
blank 


The sequence symbol in the name field can only be referenced by an AGO statement. 


The operand field must have two operands, separated by a comma. The first operand is a 
positive arithmetic set expression that indicates the number of iterations to be executed. 
The second operand is a sequence symbol! that specifies the last statement of the loop. This 
sequence symbol must appear in the name field of a statement that follows, not precedes, 
the ADO statement. The sequence symbol! cannot be in the name field of another ADO 
statement, a macro instruction, or an AGO statement. 


If the set expression is equal to zero, control is transferred to the statement named in the 
second operand, and no intervening code is included. However, if the first operand is a 
positive number, the assembler subtracts 1 from the first operand and includes in the 
assembly all the code from the ADO statement to the statement named in the second 
operand. If the first operand is zero after the subtraction, the assembler does not return to 
the ADO statement but processes the next statement. If the first operand is not zero after 
the subtraction, the assembler again subtracts 1 from the first operand and repeats the loop. 
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Notice that when the first operand initially is zero, the jump is made to the statement 
named in the second operand. When the first operand is not initially zero, the indicated 
number of loops is performed and a jump is made to the first statement after the statement 
named in the second operand. If the first operand is invalid, the value is set to 1. 


The name field may contain a sequence symbol, a set symbol, or a blank. If the name field 
contains a set symbol, the symbol is initially assigned a value of 1. For each iteration, this 
value increases by one while the first operand of ADO decreases by one. Thus, in the 
following example, after 10 iterations, the first operand is O and &COUNT is 10. 


OPERATION OPERAND 
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The preceding statement performs a function equivalent to the following three statements. 
During the first iteration, &COUNT equals 1 and the first operand (10) is decreased by one. 
After 10 iterations, &COUNT equals 10 and the first operand equals 0. Control is then 
transferred to the first statement following the .END statement. 


OPERATION OPERAND 


12.3.4 5 6 7 8{9] 10 11 1213 14 15 16 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 3839 40 41 42 43.44 45 46 47 48 49 50 


se Ey cence epee Sean Care Beaway tetas cia Ween A. ane cae ee 
. ia bu END. _ ah: heehee a i Ae a whe Bd gees cake a ke A 
= au ri. Pe ec! ame aie ae ea 1M Cae lasers Coase aoe Paid Sue! (RAE SPRY mee Dee Cae) Cee eas eee Ce aT 


The ADO statement can be used to include or exclude code from the assembly, depending 
upon the value of the first operand, as in the following example. If the variable symbol 
&LABEL is equal to YES, the first operand of the ADO statement is 1, and all intervening 
code is included in the assembly. If, however, &LABEL is not equal to YES, the first 
operand is zero and all intervening code is excluded. 


nh ierenere 
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NESTING OF ADO STATEMENTS 


As many as six ADO statements can occur within a primary ADO loop. Such nesting of 
ADO statements increases the total number of iterations in geometric progression. If five 
iterations are performed by an outer ADO loop, an inner ADO with five iterations increases 
the number of iterations to 25. An inner ADO statement cannot reference a statement 
outside one referenced by the outer ADO. 


The following statements produce a 5 x 5 matrix containing all products of the ordinary 
numbers 1 through 5. 


NAME fl OPERATION i OPERAND 
12 3 4 5 6 7 8{9] 10 11 1213 14 15 16 17] 18| 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 36 36 37 3839 40.41 42 43.44 45 46 47 48 49 50 
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During the first iteration of the outer ADO (named &COL), &COL equals 1 and &ROW 
increases by 1 with each iteration of the &ROW ADO statement until &ROW equals 5. 
During this first iteration, the statement .END WDD &COL *&ROW produces the values 1, 
2, 3, 4, and 5, as shown in the first column of values in this matrix. 


First Pass of the Outer ADO 


&COL 
2 3 4 #5 


on 


&ROW 


oOhWN — 
aohwaN = 


During the second iteration of the outer ADO, &COL equals 2 and &ROW again equals 1 
through 5. The second column of values is produced. 


Second Pass of the Outer ADO 


&COL 
1 2 3 4 #5 
1 1 2 
2 2 4 
&ROW 3 3 6 
4 4 8 
5 5 10 
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This process continues until the outer ADO has performed five iterations, at which time the 
5 x 5 matrix contains the following values: 


&COL 


1 1 2 3 4 «5 
2 2 4 6 8. 10 
&ROW 3 3 6 9 12 15 
4 4 8 12 16 20 
5 5 10 15 20 25 


AGO — UNCONDITIONAL BRANCH 


The AGO statement transfers control to a statement named in its operand field. Statements 
between the AGO statement and the statement to which the jump is made are not included 
in the assembly. The format of the AGO statement is: 


Operand 


Sequence Sequence symbol 


symbol or 
blank 


The sequence symbol in the operand field must appear in the name field of a statement 
following, not preceding, the AGO statement. An AGO statement can transfer control out 
of an ADO loop. If an AGO statement transfers control into the range of an ADO loop, the 
source statements are processed as if no ADO loop exists. 


The AGO statement cannot jump into or out of a macro. An example of the AGO statement 
appears with the description of the ANOP statement in the following text. 

ANOP — LABEL DEFINITION 

The ANOP statement identifies a statement area to which a jump can be made. Because the 


ANOP statement is used for name field identification only, it has no operands and no 
operation is performed. The format of the ANOP statement is: 


Sequence Not used — ignored 
symbol by the assembler 


If the programmer wants to use an ADO or AGO statement to branch to another statement, 
he must place a sequence symbol in the name field of the statement he wishes to branch to. 
However, if the name field already has an ordinary symbol or a variable symbol, a sequence 
symbol cannot be placed in the name field. To solve this problem, the programmer can place 
an ANOP statement before the statement he wishes to branch to, and branch to the ANOP 


10-23 


statement. This arrangement has the same effect as branching to the statement immediately 
after the ANOP statement. 


In Figure 10-10, the AGO statement performs an unconditional branch to the ANOP 
statement. All intervening code is excluded from the assembly. 


OPERAND 


"19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 3839 40 41 42 4344 45 46 47 48 49 50 


. ‘ , 4 ao Sh, “Hees ce pie meee Caren aera Eee eee ewe SUE anes Cres pees Cees era ese ‘ wsey 4 $2. Ae 


Figure 10-10. Example of the AGO Statement 


COUNT AND NUMBER ATTRIBUTES 


Count and number attributes are unique to macro instruction operands. These attributes can 
be referred to only in set expressions used as operands in conditional assembly statements 
within macro definitions. 


COUNT ATTRIBUTE 


The count attribute is a value equal to the number of characters in the macro instruction 
operand after substitution of variable symbols in the operand. All characters in the operand, 
including escape characters, are included in this count. If the operand is a sublist, the count 


attribute includes the embracing parentheses and the commas within the sublist. The count 
attribute of an omitted operand is zero. 


If an operand contains variable symbols, the characters that replace the variable symbol, 
rather than the variable symbols, determine the count attribute. 


The notation for the count attribute is K’ immediately followed by the symbolic parameter 
that corresponds to the operand. 
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The examples in Figure 10-11 illustrate the preceding rules. 


Macro Instruction Count 
Symbolic Parameter Operand Attribute Count Value 
&PAR ALPHA K'&PAR 5 
&PAR1 (JUNE JULY, AUGUST) K'&PAR1 18 
&PAR2 2(10,12) K’&PAR2 8 
&PAR3 C’ABH #3" K'&PAR3 9 


Figure 10-11 Examples of the Count Attribute 


To reference the count attribute of a suboperand, K’ followed immediately by a subscripted 
symbolic parameter must be used, as in the example: K’&PAR(3). K’&PAR(3) refers to the 
count attribute of the third suboperand of the symbolic parameter &PAR. 


NUMBER ATTRIBUTE 
The number attribute is a value equal to the number of suboperands in an operand sublist. If 
the operand in the macro instruction is not a sublist, the value of the number attribute is 


one. The number attribute of an omitted operand is zero. 


The notation for the number attribute is N’ immediately followed by the symbolic 
parameter that corresponds to the operand, as in the example: N’'&PAR. 


In the following macro instruction, the count attribute of the operand is 19, while the 
number attribute is 3: 


OPERAND 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


| CLNPUT, OUTPUT, LIST) 2.00. 


a It hrs i he Bs = 3 Sa a pa ee 


Sh a, ha Fl Bg Lethe So ek. ieee erent hola & sdb ode ee ee 


The following example has three operands, each with a number attribute of 1; their count 
attributes, however, are 5, 6; and 4, respectively. 


OPERAND 


|RNPUT, OUTPUT ,LIST............... 


wk Be a a kk atoll 


ew ees Seen Sees ene ih de hd os es eS (sD Saeeeee eee ees Sn Dene! nen Gina OO SOO ne ne Se! Gee Bp 
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ll. CONTROL LANGUAGE STATEMENTS 


The Control Language for the assembler must provide the following four basic services: 


1. Call the assembler into execution 

2. Specify the assembly options 

3. Define source input, object output, source output, and macro library 
input files 

4. Obtain the source program from the card reader, library member, or 
spooled input 


The Control Language statements for the assernbler are explained below. For the exact 
format of the statements, consult the MRX/OS Control Language Services, Extended 
Reference manual. 


Control 
Language 
Statement Parameter Description 
//EXEC PGM= ASM Calls the assembler into execution. 
//PAR Keyword options Specifies the assembly options in 
free form. 


//PAR IMEM= Input-member-name Specifies the name of the input source 
: | module on the library. If omitted, the 
source is assumed to be a non- 
partitioned sequential data file (such 
as a spooled input file). 


Bulletin: 2202.001-0101 
Date: 3/19/73 


Control 
Language 
~ Statement Parameter Description 

//PAR OMEM1= Output-member-name Specifies the name of the relocatable 
object module on the library. If 
omitted and OBJECT=YES or COND, 
the assembly is aborted. 

//PAR OMEM2= Punch-indicator 1-10 alphabetic characters to indicate 
that PUNCH output is expected. If 
omitted, no PUNCH output is produced. 

//PAR MAXSIZ= 1-5 decimal digits Specifies the approximate number of 
source lines generated in the program. 

If omitted, the default value is the 
SYSGEN parameter, usually 1000. 
//PAR LIST= YES Specifies whether the source program is 
NO to be listed: 
YES List source program 
NO Omit listing 
If omitted, the default parameter is 
| YES. 
//PAR XREF= ca Specifies whether a cross-reference list 
NO is to be generated: 
YES Generate cross-reference list 
NO Omit cross reference list 
If omitted, the default parameter is YES. 
//PAR ERROR= YES Specifies whether warning errors are to 
NO be listed: 
YES — List warning errors 
NO Omit listing 
If omitted, the default parameter is YES. 
Fatal errors are always listed. 
//PAR OBJECT= YES | Specifies under what conditions a relocatable | 
NO object module is to be generated: 
COND) 


YES Module is generated unconditionally 
NO Module is not generated 
COND Module is generated if no fatal 

error occurred 


If omitted, the default parameter is YES. 
If the option, YES or COND, is selected, 
the OMEM1 option must be specified. 
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Control 
Language 


Statement 


//DEF !D= 


//DEF ID= 


//DEF ID= 


//DEF ID= 


//DEF ID= 


//DEF ID= 


Parameter 


File identifier 


INPUT 


OUTPUT1 


OUTPUT2 


LIST 


MACLIB 
MACLIB1 
MACLIB2 


MACLIB9 


Buliletin: 2202.001-0101 
Date: 3/19/73 


Description 


Defines the source input, object output, 
source output, list output, and macro 
library input files. 


Source input file 


Relocatable output file: must be 252 
bytes, blocked 1. The file must be a 
partitioned data file. The device must 
be disc. CSD=YES 


Source punch file identifier: must be 
80 bytes, blocked 1. The file must be 
a non-partitioned sequential data set. 
CSD=YES 


List output file: must be 132 bytes, 
blocked 1. The file must be a sequential 
data set. CSD=NO. The file is written 
with the first character being a ‘‘native”’ 
mode control character for a printer. 


Macro library input: the files must be 
partitioned data sets, CSD format, 80 
byte records, blocked 1. 


Bulletin: 2202.001-0101 
Date: 3/19/73 


The INPUT and LIST files must always be defined; the OUTPUT1 and OUTPUT2 files are 
optional. //DEFINE statements may also include keyword parameters to identify the file 
name or the device with which the file is associated. 


System macros are cataloged on the $SYSMACLIB file. Additional macro libraries may be 
specified by the user in a hierarchical search. The search is controlled by //DEFINE cards; 
the hierarchy is as follows: 


ID=MACLIB (Highest priority) 
ID=MACLIB1 

ID=MACLIB2 

ID=MACLIB3 

ID=MACLIB4 

ID=MACLIB5 

1ID=MACLIB6 

1D=MACLIB7 

ID=MACLIB8 

ID=MACLIB9 = (Lowest priority) 


MACLIB is optional; if it is not supplied, the default is $SYSMACLIB, and this file will be 
the highest priority in the search. $SYSMACLIB can be used at a lower priority by 
specifying it as the filename on the //DEFINE card for a lower priority library, and naming 
some other library on the //DEFINE card for ID=MACLIB. The remaining libraries, 
MACLIB1 through MACLIBQY, must be specified if they are to be searched, and must appear 
in. the order shown above. Any break in the sequence of these libraries terminates the 
search. For example, if cards are supplied in order for MACLIB1, MACLIB2, and MACLIB4, 
the search will terminate with MACLIB2, since MACLIB3 is missing. 


The search is a true hierarchical search; that is, if a macro is called that resides on a low 
priority library, the search for the macro starts at the highest priority library. 


if the source program is to be read from the card reader, the source program card deck must 
be preceded by a //DATA FIL=SYSCRD statement and be terminated by a /* card. 
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Bulletin: 2202.001-0101 
Date: 3/19/73 


The cards in Figure 11-1 illustrate the Control Language statements to specify: 


e Source input from cards 

e Relocatable output to a specified library member 
cS] ist output to printer 

® Cross-reference output 


Source 
Program 


/IDATA FIL=SYSCRD 
" //PAR OMEM1=PRG2,XREF=YES 


//DEF iD=OUTPUT1,FIL=$LIB 


/IDEF ID=LIST,DEV=PRINTER 
' DEF [{D=INPUT,DEV=SYSCRD 


HEXEC PGM=ASM 


Figure 11-1. Example of Control Language Statements 
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The cards in Figure 11-2 illustrate the Control Language statements to specify: 


@ Source input from spooled input file 

e Relocatable output to a specified library member 
e List output to printer 

e Cross-reference output 


Source 
Program 


//DATA FIL=name 


//PAR OMEM1=PRG2,XREF=YES 


//(DEF ID=OUTPUT1,FIL=$LIB 


//DEF ID=LIST,DEV=PRINTER 


//DEF ID=INPUT,FIL=name 


//EXEC PGM=ASM 


Figure 11-2. Example of Control Language Statements 


The cards in Figure 11-3 illustrate the Control Language statements to specify: 


@ Source input from a library file 

e Relocatable output to a specified library member 
e List output to printer 

é Cross-reference output 


/IPAR OMEM1=PRG2,XREF=YES 
/DEF 1D=OUTPUT1,FIL=$LIB 
//DEF ID=LIST,DEV=PRINTER 
//DEF 1D=INPUT,FIL=MYSOURCEFIL,STA=(P,1) 


//EXEC PGM=ASM 


Figure 11-3. Example of Control Language Statements 


To place the intermediate files on non-shared resource discs, any or all of the cards in Figure 
11-4 may be included in the job control stream: 


//DEF 1ID=MRELFIL,FIL=DUMMY,VOL=userpack 
//DEF ID=MRMRGFIL,FIL=DUMMY ,VOL=userpack 
//DEF 1D=MRSRTFIL,FIL=DUMMY ,VOL=userpack 
//DEF ID=MRTEXT01,FIiL=DUMMY ,VOL=userpack 
//DEF 1D=MRVIRTAL,FIL=DUMMY ,VOL=userpack 


//DEF ID=MRXRFFIL,FIL=DUMMY ,VOL=userpack 


Figure 11-4. Placing Files on Disk — Example 
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The file MRTEXTO1 has the highest traffic and would be the best candidate for 
performance enhancement. The file MRXRFFIL is used in macro generation and cross 
reference generation programs. The files MRSRTFIL and MRMRGFIL are used for cross 
reference. The file MRVIRTAL is used primarily for symbol table overflow. The file 
MRELFIL is used for error output. 


A. EBCDIC REPRESENTATION 


EBCDIC EBCDIC 


Hex 
Code } Graphic Card Code 


BEL 0-7-8-9 
12-11-0-1-8-9 


Card Code 


12-0-1-8-9 
12-1-9 
12-2-9 
12-3-9 
12-4-9 
12-5-9 
12-6-9 
12-7-9 
12-8-9 
12-1-8-9 
12-2-8-9 
12-3-8-9 
12-4-8-9 
12-5-8-9 
12-6-8-9 
12-7-8-9 
12-11-1-8-9 
11-1-9 
11-2-9 
11-3-9 
11-4-9 
11-5-9 
11-6-9 
11-7-9 
11-8-9 
11-1-8-9 
11-2-8-9 
11-3-8-9 
11-4-8-9 


1-8-9 
2-8-9 
3-8-9 
4-8-9 
5-8-9 
6-8-9 
7-8-9 

No punches 
12-0-1-9 
12-0-2-9 
12-0-3-9 
12-0-4-9 
12-0-5-9 
12-0-6-9 
12-0-7-9 
12-0-8-9 
12-1-8 
12-2-8 
12-3-8 


IGS 

IRS 
ITB(IUS) 
DS 

SOS 

FS 


BYP 

LF 
EOB/ETB 
ESC/PRE 


11-5-8-9 
11-6-8-9 
11-7-8-9 
11-0-1-8-9 
0-1-9 
0-2-9 
0-3-9 
0-4-9 
0-5-9 
0-6-9 
0-7-9 
0-8-9 
0-1-8-9 
0-2-8-9 
0-3-8-9 
0-4-8-9 
0-5-8-9 
0-6-8+9 


A-1 


12-4-8 
12-5-8 
12-6-8 
12-7-8 

12 
12-11-1-9 
12-11-2-9 
12-11-3-9 
12-11-4-9 
12-11-5-9 
12-11-6-9 
12-11-7-9 
12-11-8-9 
11-1-8 
11-2-8 
11-3-8 
11-4-8 
11-5-8 


EBCDIC EBCDIC 


Hex 
Card Code Code Card Code 


11-6-8 95 12-11-5 
11-7-8 96 12-11-6 
11 97 12-11-7 
0-1 98 12-11-8 
11-0-2-9 99 12-11-9 
11-0-3-9 9A 12-11-2-8 
11-0-4-9 9B 12-11-3-8 
11-0-5-9 9C 12-11-4-8 
11-0-6-9 9D . 12-11-5-8 
11-0-7-9 9E 12-11-6-8 
11-0-8-9 OF 12-11-7-8 
0-1-8 AO 11-0-1-8 
12-11 Al 11-0-1 
0-3-8 A2 s 11-0-2 
0-4-8 A3 t 11-0-3 
0-5-8 A4 u 11-0-4 
0-6-8 A5 v 11-0-5 
0-7-8 A6 Ww 11-0-6 
12-11-0 A7 x 11-0-7 
12-11-0-1-9 A8 y 11-0-8 
12-11-0-2-9 AQ z 11-0-9 
12-11-0-3-9 AA 11-0-2-8 
12-11-0-4-9 AB 11-0-3-8 
12-11-0-5-9 AC 11-0-4-8 
12-11-0-6-9 AD 11-0-5-8 
12-11-0-7-9 AE 11-0-6-8 
12-11-0-8-9 AF 11-0-7-8 
1-8 BO 12-11-0-1-8 
2-8 B1 12-11-0-1 
3-8 B2 12-11-0-2 
4-8 B3 12-11-0-3 
5-8 B4 12-11-0-4 
6-8 B5 12-11-0-5 
7-8 B6 12-11-0-6 
12-0-1-8 B7 12-11-0-7 

a 12-0-1 B8 12-11-0-8 

b 12-0-2 B9 12-11-0-9 

Cc 12-0-3 BA 12-11-0-2-8 

d 12-0-4 BB 12-11-0-3-8 

e 12-0-5 BC 12-11-0-4-8 

f 12-0-6 BD 12-11-0-5-8 

g 12-0-7 BE 12-11-0-6-8 

h 12-0-8 BF 12-11-0-7-8 

i 12-0-9 e) 12-0 
12-0-2-8 Ci A 12-1 
12-0-3-8 C2 B 12-2 
12-0-4-8 C3 C 12-3 
12-0-5-8 C4 D 12-4 
12-0-6-8 C5 E 12-5 
12-0-7-8 C6 F 12-6 
12-11-1-8 C7 G 12-7 
12-11-1 C8 H 12-8 
12-11-2 C9 | 12-9 
12-11-3 CA 12-0-2-8-9 


12-11-4 cB | 12-0-3-8-9 
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EBCDIC EBCDIC 


Graphic Card Code Graphic Card Code 


12-0-4-8-9 
12-0-5-8-9 
12-0-6-8-9 
12-0-7-8-9 
11-0 11-0-2-8-9 
11-1 11-0-3-8-9 
11-2 11-0-4-8-9 
11-3 11-0-5-8-9 
11-4 11-0-6-8-9 
11-5 11-0-7-8-9 
11-6 0 

11-7 

11-8 

11-9 
12-11-2-8-9 
12-11-3-8-9 
12-11-4-8-9 
12-11-5-8-9 
12-11-6-8-9 
12-11-7-8-9 


J 

K 
L 
M 
N 
O 
P 

Q 
R 


COON OA PWNH— SO 
On oOon»hWnD = 


9 

12-11-0-2-8-9 
12-11-0-3-8-9 
12-11-0-4-8-9 
12-11-0-5-8-9 
12-11-0-6-8-9 
12-11-0-7-8-9 


B. OBJECT FORMATS OF MACHINE INSTRUCTIONS 


The notation used to describe the source and object format in Appendixes A and B is as follows (a = 
absolute, r = relocatable expression). . . 


Op Code 
R 
E 


Hexadecimal 00-F F 

General register, 0-7. (a) 

Extended register, 0-15. (a) 

Memory address, 0-65,535. (a or r) 

Immediate value-arithmetic value, shift count, skip count, or bit number. (a) 
Field length, 0-255 (for MOVL, 0-65,535). (a) 

Parentheses enclose index registers and field lengths, both of which are optional. 


A bullet following an instruction name indicates the operands are byte-addressable; other 
operands are word-addressable only. 


Bits 8 and 12 of the object instructions are used in almost every instruction to convey information to the 
computer concerning that instruction. If these bits are not interpreted in any way, they are shaded; 
otherwise, the following symbols are used to define bits 8 and 12. 


1,0 


Indirect addressing indicator; for direct addressing i=O, for indirect addressing i=1. Indirect 
addressing is indicated by the programmer. 


A sub-function indicator; indicates a function that the operation code alone cannot do. 
These function bits are set by the assembler. . 


If bit 8 or 12 must be a 1 or a O for a particular instruction, the bit will be shown as a 1 or 
0. These bits are set by the assembler; if the wrong bit state appears in the object instruction, 
a no-operation occurs. 


TWO BYTE INSTRUCTIONS 


Op Mnemonic 

Code Code Description 

22 ADDR Add Register-Register 

23 SUBR Subtract Register-Register 

29 DIVR Divide Register-Register 

28 MPYR Multiply Register-Register 

25 ANDR Logical Product Register-Register 

26 EORR Exclusive OR Register-Register 

27 {ORR Inclusive OR Register-Register 

21 CMPR Compare Register-Register 

20 MOVR Move Register-Register 

24 INVR Inverse Move Register-Register 

6F ROFR Reverse Off-Bit 

6D RONR Reverse On-Bit 

6E TOFR Test for Off-Bit 

6C TONR Test for On-Bit 

32 ADDI Add Immediate 

33 SUBI Subtract Immediate 

39 DIVI Divide Immediate 

38 MPYI Multiply Immediate 

35 ANDI Logical Product Immediate 

36 EORI Exclusive OR Immediate 

37 IORI Inclusive OR Immediate . 

31 CMPI Compare Immediate 

30 LODI Load Immediate 

34 INVI Inverse Move immediate 

F5 INP Input from 1/O Register 

F6 OUT Output to I/O Register 

81 INT Convert float to fixed 

81 INTT Convert float to fixed 
two-word 

82 FLT Convert fixed to float 

82 FLTT Convert fixed to float 
two-word 


Word/Operand 
Format 


0 7 8 9 11 12 13 15 


| oe fit ms ff me 


Source Operands: @R4,@Ro 


QO 7 8 11.12 13 15 


| oo fff me 


Source Operands: 14,@R9 


0 7 8 9 11. 12 13 


Source Operands: @R4,R5 


0 7 8 9 11. 12 13 15 


Source Operands: @R, 
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Op 
Code 


5F 


4F 


5C 


4c 


5D 


4D 


5E 


4E 


47 


46 


43 


42 


45 


a4 


41 


40 


3F 


OF 


3C 


2C 


3D 


2D 


3E 


2E 


F2 
F1 


Mnemonic 


Code 


ARDI 


ARSI 


LLDI 


LLS! 


LRDI 


LRSI 


RLDI 


RLSI 


SRMB 


SRMF 


SRNB 


SRNF 


SRPB 


SRPF 


SRZB 


SRZF 


ARDR 


ARSR 


LLDR 


LLSR 


LRDR 


LRSR 


RLDR 


RLSR 


DIO 
slo 


Description 


Arithm. Right Double Shift 
Immediate 

Arithm. Right Single Shift 
Immediate 

Logical Left Double Shift 
immediate 

Logical Left Single Shift 
Immediate 

Logical Right Double Shift 
Immediate 

Logical Right Single Shift 
Immediate 

Rotating Left Double Shift 
Immediate 

Rotating Left Single Shift 
Immediate 

Skip if Register is Minus 
Backward 

Skip if Register is Minus 
Forward 

Skip if Register Not Zero 
Backward 

Skip if Register Not Zero 
Forward 

Skip if Register is Plus 
Backward 

Skip if Register is Plus 
Forward 

Skip if Register is Zero 
Backward 

Skip if Register is Zero 
Forward 


Arithm. Right Double Shift 
By Register 

Arith. Right Single Shift 
By Register 

Logical Left Double Shift 
By Register 

Logical Left Single Shift 
By Register 

Logical Right Double Shift 
By Register 

Logical Right Single Shift 
By Register 

Rotating Left Double Shift 
By Register 

Rotating Left Single Shift 
By Register 

Disk 1/0 

System 1/O 


Word/Operand 
Format 


11 12 13 15 


Source Operands: 1,,R9 


0 7 8 9 


11 12 13 15 


Source Operands: @Ry1,R9 
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Op Mnemonic Word/Operands 


Code Code Description Format 
0 7 8 9 11 12 15 
EB BR Branch to Address in Register ie 


2B CLDR Condition Register Load 


Source Operands: @R, 


0 7 8 15 
BB SB Skip Unconditional Backward bp Cod 
BA SF Skip Unconditional Forward ae 


Source Operands: | 1 


4B SCFB Skip on Condition Register 
False - Back + 49 
49 SCFF Skip on Condition Register { 


True - Back 


False - Forward 
4A SCTB Skip on Condition Register Op Code 
48 SCTF Skip on Condition Register Source Operands: 14,19 
True - Forward 
9 


0 7 8 


Source Operand: @1, 


10 RBA Reset Busy/Active Register 
10 SBA Set Busy/Active Register 789 11 12 13 15 
14 RCN Reset Control Register 
D2 Eee Cee le lle 
15 RPM Reset Privileged Mode 
Register . 
15. SPM Set Privileged Mode Register pource Open Sia crtiil 
0 7 8 11 12 15 
12 CTB Clear Tie-Breaker Register 
11 TST Test and Set Tie-Breaker 
Register 


Source Operand: 1, 


Op Mnemonic Word/Operand 


Code Code Description Format 
0 9 11.12 13 15 
EF BCM Branch to Control Memory 
F4 WRC Communications Output 
Command 


Source Operands: R4,R9 


0 7 8 11 12 13 15 


FO RDX Read Extended Register 
FO WRX Write Extended Register Op Code f 


Source Operands: E1,Ro 


F3 RDC Communications 1/O 
80 NEGF Negate Floating Point 
0 7 8 11 12 13 15 
2A CSTR Condition Register Store 
3A PSTR Program Address Store 


Source Operand: @R, 
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FOUR BYTE INSTRUCTIONS 


Op Minemonic Word/Operand 
Code Code _—S—_—sCDeesscrription Format 

A2 ADD Add 

72 ADDT Add Two-Word 

A3 SUB Subtract 

73 SUBT Subtract Two-Word 

AQ DIV Divide 

A8 MPY Multiply 

A5 AND Logical Product 

A6 EOR Exclusive OR 

A7 IOR Inclusive OR 

F9 CBY Compare Byte e 

Al CMP Compare 

71 CMPT Compare Two-Word 0 7 8 9 11 12 13 
A eT 
F7 LODB Load Byte Memory-Register @ Up Sod 

FA STO Store Register-Memory 

F8 STOB Store Byte Register-Memory e Source Operands: @M4(R4),@R9 

FB STOT Store Two-Word 

A4 INV Inverse Move Memory-Register 

E4 BA1 Branch Add 1 

E5 BA2 Branch Add 2 

E1 BRN Branch if Register is Not Zero 

EO BRZ Branch if Register is Zero 

E6 BS1 Branch Subtract 1 

E7 BS2 Branch Subtract 2 

EA BSR Branch and Save Return 

EE NOP No Operation 

B2 ADDD Add Direct 

B3 SUBD Subtract Direct 

B9 DIVD Divide Direct 

B8 MPYD Multiply Direct 

B5 ANDD Logical Product Direct 

B6 EORD Exclusive OR Direct 

B7 1IORD Inclusive OR Direct 

BI CMPD Compare Direct Source Operands: 14(R4),@R2 

BO LODD Load Direct 

B4 INVD Inverse Move Direct 

7 8 9 11 12 13 15 

84 LODF Load floating point - 
ee 
85 SUBF Subtract floating point 

89 DIVF Divide floating point 


Source Operands: @M4(R4),Ro 
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Op 


Code 


EQ 


E8 


E2 
E3 


AA 
AA 


AB 
AB 


ED 
EC 
87 
8A 


FE 
FE 
FF 
FF 
FD 
FD 


Mnemonic 


Code 


BCF 


BCT 


BOF 
BON 


CVB 
CVBT 


CVD 
CVDT 


IBIT 

RBIT 
SBIT 
TBIT 


RAR 
WAR 
RSAR 
SAR 
RRO 
WRO 


Description 


Branch on Condition 
Register - False 
Branch on Condition 
Register - True 
Branch if Bit is Off 
Branch if Bit is On 


Convert to Binary e 
Convert to Binary 
Two-Word o 
Convert to Decimal e 
Convert to Decimal 
Two-Word e 


Invert Bit @ 
Reset Bit e@ 
Set Bit @ 
Test Bit e 


Branch-Post Indexing 
Branch-Pre Indexing 


Compare floating point 
Store floating point 


Read Any Register 
Write Any Register 
Restore All Registers 
Save All Registers 
Read Register Options 
Write Register Options 


Word/Operand 
Format 


8 9 11.12 13 15 


Source Operands: @M4(R ) 


7 8 9 11. 12 13 


ee 


Source Operands: 14(R7),@R9 
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SIX BYTE INSTRUCTIONS 


Op Mnemonic 


Code Code 
62 ADDM 
63 SUBM 

69 DIVM 

68 MPYM 
65 ANDM 
66 EORM 
67 1ORM 

6B CBYM 
61 CMPM 
6A MOVB 
60 MOVM 
64 INVM 

3B SHFK 


Description 


Add Memory-Memory 

Subtract Memory-Memory 

Divide Memory-Memory 

Multiply Memory-Memory 

Logical Product Memory- 
Memory 

Exclusive OR Memory- 
Memory 

Inclusive OR Memory- 
Memory 

Compare Byte Memory- 
Memory e 

Compare Memory-Memory 

Move Byte Memory-Memory @ 

Move Word Memory-Memory 

Inverse Move Memory- 
Memory 


Shift Packed Decimal @ 


Word/Operand 
Format 


0 7 8 9 


Source Operands: @M,(R4),@M9(R9) 


Source Operands: M4(L4,R4),!9(R) 


11 12 13 


15 


EIGHT BYTE INSTRUCTIONS 


Op Mnemonic 
Code Code Description. 
52 ADDK Add Packed Decimal e 
53 SUBK Subtract Packed Decimal e 
51 CMPK Compare Packed Decimal e 
55 CMPX Compare Characters @ 
54 MOV X Move Characters @ 
58 PAKX Pack e 
59 UNPX Unpack @ 
50 ZADK Zero and Add Decimal e 
57 EDTX Packed Decimal/Alpha 

Edit e 
7C DIVK Divide Packed Decimal e 
5B MPYK Multiply Packed Decimal e 
56 TRNX Translate e 
5A MOVL Move Long e 


Word/Operand 
Format 


8 9 11 12 13 15 


0 7 
Lo 


Ly 


Source Operands: M4(L41,R7),Mo9(Lo,R9) 


0 7 


2 


Source Operands: M4(L4,R4),M9(R9) 
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C. ALPHABETICAL LIST OF MNEMONICS 


This appendix lists all machine mnemonic codes and extended mnemonic codes in alphabetical order. Also 
included are the hexadecimal function codes, the instruction size in bytes, and the configuration of the 
source operand. An asterisk in the function code column indicates an extended mnemonic code. The 
symbols used in the operand configuration are the same as in the preceding lists. 


Mnemonic Operation Instruction 

Code _ Code __ Size (Bytes) Operand Configuration 
ADD A2 4 @M4(R4),@Ro 
ADDD B2 4 14(R4),@Ro 
ADDF 86 4 @M 4(R4),Ro 
ADDI 32 2 14,@Ro 

ADDK 2 8 M4(L4,R4),Mo(Lo,R9) 
ADDM 62 6 @M4(R4),@Mo(Ro) 
ADDR 22 2 @R1,@R5 

ADDT 72 4 @M4(R4),@R2 
AND AS 4 @M4(R7),@R> 
ANDD B5 4 14(R4),@Ro 

ANDI 35 2 11,@R2 

ANDM 65 6 @M4(R4),@Mz(Ro) 
ANDR 25 2 @R1,@Ro 

ARDI 5F 2 1q,Ro 

ARDR 3F 2 @R1,Ro 

ARSI 4F 2 14,Ro 

ARSR 2F 2 @R1,R9 

B ED 4 @M4(R4) 

BAI E4 4 @M4(R4),@Ro 
BA2 ES 4 @M4(R7),@Ro 
BBR i @M4(R4) 

BBS ij @M4(R4) 

BCF EQ 4 @M4(R4), 19 

BCH EC 4 @M4(R4) 

BCM EF 2 R4,R9 

BCT E8 4 @M4(R4),!9 

BCY i @M4(R4) 

BEQ - @M4(R4) 

BGE : @M4(R4) 

BGT ~ @M4(R4) 

BID . @M 4(R4) 

BKM ss @M4(R4) 

BKP @M4(R4) 

BKZ * @M4(R4) 

BLE | @M4(R4) 

BLEQ @M4(R4) 

BLGE i @M4(R4) 
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Mnemonic Operation Instruction 


Code Code Size (Bytes) Operand Configuration 
BLGT a @M 4(R4) 

BLLE * @M4(R4) 

BLLT : @M41(R4) 

BLNE . @M 4(R4) 

BLT x - @M4(R4) 

BNC * @M4(R4) 

BNE " @M4(R4) 

BNI = @M4(R4) 

BNV = @M4(R4) 

BOF E2 4 @M4(R4),19 

BON E3 4 @M4(R4),l9 

BOV = @M4(R4) 

BR EB 2 @R, 

BRN E1 4 @M4(R4),@R2 
BRZ EO 4 @M4(R7),@R2 

BS1 E6 4 @M4(R7),@R> 

BS2 E7 4 @M4(R7),@R2 
BSR EA 4 @M4(R4),@Ro 
CBY F9 4 @M4(R1),@Ro 
CBYM 6B 6 @M 4(R4),@Mo(R9) 
CLDR 2B 2 @R, 

CMP Al 4 @M4(R4),@Ro 
CMPD B1 4 14(R4),@Ro 

CMPF 87 4 @M4(R4} 

CMPI 31 2 14,@R2 

CMPK 51 8 M4(L7,R4),My(Lo,R9) 
CMPM 61 6 @M4(R7),@Mo(R9) 
CMPR 21 2 @R1,@R9 

CMPT 71 4 @M4(R7),@R2 
CMPX 55 8 M4(L4,R4),Mo(Lo,R9) 
CSTR 2A 2 @R, 

CTB 12 2 ly 

CVB AA 4 @M4(R4),Ro 
CVBT AA 4 @M4(R4),Ro 

CVD AB 4 @M4(R4),Ro 
CVDT AB 4 @M4(R4),Ro 

DIO F2 2 @R4,R9 

DIV AQ 4 @M1(R1),@R2 
DIVD B9 4 14(R4),@Ro 

DIVF 89 4 @M4(R4),Ro 

DIVI 39 2 14,@R2 


Mnemonic Operation Instruction 
Code Code Size (Bytes) Operand Configuration 


DIVK 7C 


Oo 


M4(L4,R4),Mo(Lo,R9) 


DIVM 69 6 @M4(R1),@Mo(Ro) 
DIVR 29 2 @R1,@Ro 

EDTX 57 8 Mj (L4,R4),.Mo(L9,R9) 
EOR AG 4 @M4(R4),@R> 
EORD BG 4 14(R4),@Ro 

EORI 36 2 11,@R2 

EORM 66 6 @M4(R1),@Mo(Ro) 
EORR 26 2 @R1,@Ro 
FLT/FLTT 82 2 @R, 

IBIT BF 4 @M4(R4),l9 

INP F5 2 11, @Ro 

INT/INTT 81 2 @R1,Ro 

INV A4 4 @M4(R4),@Ro 
INVD B4 4 14(R4),@R> 

INVI 34 2 14,@Ro 

INVM 64 6 @M4(R4),@My(Ro) 
INVR 24 2 @R1,@Ro 

IOR A7 4 @M4(R1),@R> 
lORD B7 4 14(R4),@Rz 

IORI 37 2 11,@R9 

1ORM 67 6 @M4(R4),@M(Ro) 
IORR 27 2 @R1,@Rz 

LLDI 5C 2 11Ro 

LLDR 3C 2 @R1,Ro 

LLSI 4C 2 1Ro 

LLSR 2c 2 @R1,Ro 

LOD AO 4 @M 4(R4),@Rz 
LODB F7 4 @M4(R4),@Rz 
LODD BO 4 14(R4),@Ro 

LODF 84 4 @M4(R4),Ro 

LODI 30 2 1,,@Ro 

LODT 70 4 @M4(R4),@R2 
LRDI 5D 2 11,Ro 

LRDR 3D 2 @R1,Ro 

LRSI | 4D 2 I,Ro 

LRSR 2D 2 @R1,Ro 

MOVB 6A 6 @M4(R4),@Mo(Ro) 
MOVL 5A 8 My(L4,R4),.Mo(Ro) 
MOVM 60 6 @M 4(R4),@Mo(Ro) 
MOVR 20 2 @R1,@R2 
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Mnemonic Operation Instruction 


__Code __Code Size (Bytes) Operand Configuration 
MOVX 5A 8 M4 (L4,R4).Mo(L2,R9) 
MPY A8 4 @M4(R4),@R2 
MPYD B8 4 14(R4),@R> 
MPYF 88 4 @M4(R4).Ro 
MPY| 38 2 14,@Ro 
MPYK 5B 8 M4(L4,R4),Mo(Lo,R9) 
MPYM 68 6 @M4(R1),@Mo(Ro) 
MPYR 28 2 @R1,@R2 
NEGF 80 2 blank 
NOP EE 4 blank or @M4(R7),@Ro 
OUT F6 2 11,@R2 
PAKX 58 8 M4(L4,R4),Mo(Lo,R9) 
PSTR 3A 2 @R, 

RAR FE 4 M4(R4),@Ro 
RBA 10 2 @Rj4,I9 or 14,19 
RBIT BD 4 @M4(R4).I5 
RCN 14 2 @Rj,I9 or 14,19 
RDC F3 2 

RDX FO 2 E1,Ro 

RLDI 5E 2 11.Ro 

RLDR 3E 2 @R4,R9 

RLSI 4E 2 14,R9 

RLSR 2E 2 @R41,R2 

ROFR 6F 2 @R1,@R> 
RONR 6D 2 @R;,@Ro 

RPM 15 2 @Rq,1p or 14,19 
RRO FD 4 M,(R4),@R2 
RSAR FF 4 M4(R4),@R> 

Ss . M, or |y 

SAR FF 4 M4(R4),@R> 
SB BB 2 ly 

SBA 10 2 @Ry,19 oF by, lp 
SBIT BC 4 @M4(R4).l9 
SBR " My or ly 

SBS My or |y 

SCF ‘ My,lg or Iy,l9 
SCFB 4B 2 Iyily 

SCFF 49 2 Iqily 

SCN 14 2 @Ry,19 or 14,19 
SCT : My,19 oF 14,15 
SCTB 4A 2 Iqily 
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Mnemonic Operation Instruction 


Code _ Code _ Size (Bytes) Operand Configuration 
SCTF 48 2 lyly 

SCY : M, or ty 

SEQ * My or ty 

SF BA 2 F 

SGE : M, or ty 

SGT x M, or 14 
SHFK 3B 6 My(L4,Rq),1o(Ro) 
SID i M, or |4 

slo FI 2 @R1,Ro 

SKM My or |4 

SKP e M4 or ly 

SKZ ‘3 M, or ly 

SLE My, or !4 
SLEQ My or ly 

SLGE : My or ly 
SLGT a M, or ty 

SLLE . M, or 14 

SLLT : M, or ty 

SLNE My or! 

SLT = My, or ly 

SNC : My or Iq 

SNE * M, or ly 

SNI . My or |y 

SNV e My, or ty 

SOV : My or 1 

SPM 15 2 @R 4,19 or 14,19 
SR 13 2 @l, 

SRM . M,,R9 or 14,R9 
SRMB 47 2 11,Ro 

SRMF 46 2 14,R5 

SRN = My,Ro or 14,19 
SRNB 43 2 I4,19 

SRNF 42 2 14,Ro 

SRP - My,R9 or 14,19 
SRPB 45 ‘2 14,R9 

SRPF 44 2 14,R> 

SRZ : My,R9 or 14,19 
SRZB 44 2 11Ro 

SRZF 40 2 1y.Ro 

STO FA 4 @M4(R4),@Ro 
STOB F8 4 @M4(R1),@Ro 


Mnemonic Operation Instruction 


Code Code Size (Bytes) Operand Configuration 
STOF 8A 4 @M4(R4) 

STOT FB 4 @M4(R7),@Ro 

SUB A3 4 @M4(R4),@R2 

SUBD B3 4 14(R4),@Ro 

SUBF 85 4 @M4(R4),Ro 

SUBI 33 2 14,@R9 

SUBK 53 8 M4(L1,R4),Mo(Lo,RQ) 
SUBM 63 6 @M4(R4),@Mo(Ro) 
SUBR 23 2 @R1,@Ro 

SUBT 73 4 @M4(R1),@R2 

TBIT BE 4 @M4(R1),l9 

TOFR 6E 2 @R1,@Ro 

TONR 6C 2 @R1,@Ro 

TRNX 56 8 M4(R4),Mo(Lo,R9) 
TST 11 2 ly 

UNPX 59 8 M,4(L4,R4),Mo(Lo,R9) 
WAR FE 4 M,4(R4),@R9 

WRC F4 2 Ry,R9 

WRO FD 4 M4(R4),@R9 

WRX FO 2 E,,R9 

ZADK 50 8 M4(L4,R4),Mo(Lo,R9) 
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D. HEX CODE TO MNEMONIC CODE 


SBA/RBA 


SCN/RCN 
SPM/RPM 
MOVR 
CMPR 
ADDR 
SUBR 
INVR 
ANDR 
EORR 
IORR 
MPYR 
DIVR 
CSTR 
CLDR 
LLSR 
LRSR 
-RLSR 
ARSR 
LOD! 
CMPI 
ADDI 
SUBI 
INVI 
ANDI 
EORI 
IORI 
MPYI 
DIVI 
PSTR 
SHFK 
LLDR 
LRDR 
RLDR 
ARDR 
SRZF 
SRZB 


SRNF 
SRNB 
SRPF 
SRPB 
SRMF 
SRMB 
SCTF 
SCFF 
SCTB 
SCFB 
LLSI| 
LRSI 
RLSI 
ARSI 
ZADK 
CMPK 
ADDK 
SUBK 
MOVX 
CMPX 
TRNX 
EDTX 
PAKX 
UNPX 
MOVL 
MPYK 
LLDI 
LRDI 
RLDI 
ARDI 
MOVM 
CMPM 
ADDM 
SUBM 
INVM 
ANDM 
EORM 
IORM 
MPYM 
DIVM 
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MOVB 
CBYM 
TONR 
RONR 
TOFR 
ROFR 
LODT 
CMPT 
ADDT 
SUBT 
DIVK 
NEGF 
INT/INTT 
FLT/FLTT 
LODF 
SUBF 
ADDF 
CMPF 
MPYF 
DIVF 
STOF 
LOD 
CMP 
ADD 
SUB 

INV 
AND 
EOR 

IOR 
MPY 
DIV 
CVB/CVBT 
CVD/CVDT 
LODD 
CMPD 
ADDD 
SUBD 
INVD 
ANDD 
EORD 


BSR 


BCH 

B 

NOP 

BCM 
RDX/WRX 
SIO 

DIO 

RDC 
WRC 

INP 

OUT 
LODB 
STOB 
CBY 

STO 
STOT 
RRO/WRO 
RAR/WAR 
SAR/RSAR 


E. SUMMARY OF ASSEMBLER STATEMENTS 


Sequence symbol, set symbol, ADO Arithmetic set expression, 
or blank sequence symbol 


Sequence symbol or blank AGO Sequence symbol 


Symbol or blank ALIGN Absolute, resolved arithmetic 


expression 


Sequence symbol ANOP Not used — ignored by the 
| assembler 


@ 
0 
oe) 


One or more operands 
separated by commas 


Symbol or blank 


Symbol or blank BRS Absolute, arithmetic 
expression 

Symbol or blank COM Not used — ignored by the 
assembler 


Symbol or blank CSECT Not used — ignored by the 
assembler 


Sequence symbol! or blank EJECT Not used — ignored by the 
assembler 


Blank Ordinary symbol or blank 
Sequence symbol or blank ENTRY 


One or more relocatable symbols 
separated by a comma 


Ordinary or variable symbol EQU Expression 


Sequence symbol or blank EXTRN One or more relocatable symbols 
separated by a comma 


Ordinary symbol FORM One or more positive arithmetic 


expressions separated by commas 
Symbol or blank Form name 
Blank GBLA 


Exp,exp,. . .,exp 


1-35 set symbols separated by 
commas 


Blank GBLC 1-35 set symbols separated by 


commas 


Blank ICTL Two decimal arithmetic constants 


separated by a comma 


Symbol or blank 
Blank 


Sequence symbol or blank 


Sequence symbol or blank 


Sequence symbol or blank 


ns re re sheen -vte—rilsteeeeh ere 


Sequence symbol or blank | 


Sequence symbol or blank 


Sequence symbol or blank 
Set symbol 
Set Symbol 


Sequence symbol or blank 
Symbol or blank 
Symbol or blank 


Symbol or blank 


Operation 


ISEQ 


LTORG 
MACRO 
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Operand 


Blank, or two decimal arithmetic 
constants separated by a comma 


Not used 


Not used — ignored by the 
assembler 


Not used — ignored by the 
assembler 


Not used — ignored by the 
assembler 


Severity code, message or 
message only 


Relocatable expression or blank 


One-to-four operands separated 
by commas 


Not used 
Arithmetic set expression 


Character term or arithmetic 
set expression 


Absolute arithmetic expression 
Character string constant 


One or more operands separated 
by commas 


Absolute arithmetic expression 


F. MACRO EXAMPLE 


The example in Figures F-1 through F-3 demonstrates the use of the FORM instruction, but 
may serve as a model for many macro language and conditional features. It shows the 
comprehensive definition for a system macro, and two MACRO instructions for that macro. 
Two are included because the definition generates some code unique to the first call. 


The formal parameter list of the definition identifies expected parameters from the call: 
IDENT, LABDEF, REWIND, USAGE, CONTROL, and LIST. Three of these (REWIND, 
USAGE, and CONTROL) have default values provided in the definition. The other three 
remain null in value, if the call does not provide an explicit value for them. 


By using relational expressions in SETA statements, the macro definition provides for the 
setting of many counters according to the parameter values provided. Hence, the first call in 
the example, whose parameter string is: IDENT=FILE1,USAGE=O, sets the counter &UO 
(line 00039) because USAGE=O was coded. 


Because of the default value YES for REWIND, counter &RY (line 00042) is also set. The 
default ANS for CONTROL sets counter &CCA (line 00045). Conversely, counters &LY 
(line 00021), &LN (line 00025), and &LB (line 00037) are zero, because the LABDEF and 
LIST parameters were not given values by the macro call. 


Note how the definition explicitly Gist for failure to provide the IDENT parameter (lines 
00048-00053). If the user does not provide it in the call, its count is zero (K’&IDENT), 
&IDNO is set to 1, and the ADO statement (line 00050) generates the fatal MNOTE 
message. In the call examples, IDENT=FILE1, the count (K’&IDENT) is 5 and &IDNO is 
not set. By similar means, the definition checks to ensure that specifications for the other 
parameters are correct. 


When all the incoming parameter values are verified and the appropriate conditional 
counters are set or reset, the macro generates the I/O packet with a FORM statement to 
designate the principal options. 


In line 00003, the macro declares the count field (@DMOCCNT) as global, and tests it for a 
zero (default) value. If it is zero, line OO005 sets it to 1. In this way, the macro determines 
whether the call is the first call within the assembly. This allows the once-only definition of 
the FORM instruction: $DMFRM, consisting of eight one-bit fields (line 00007). (Also note 
the use of the same code to generate an external for $DMOCC (line 00006), an external 
subroutine.) 


The FORM reference is generated through the $F1 SETC (line 00069), which creates the 
character string $DMFRM to be used at line 00072. In the operand fields of the FORM 
reference, SETA references pick up the counters established by earlier conditional 
instructions. 


In the first call shown, USAGE=O sets &UO=1 and REWIND=YES (default) sets &RY=1. 
Since the operand string of the &F1 statement was &CCN,0,0,0,&VO,&VV,&RY,&LB, the 
$DMFRM generates 0,0,0,0,1,0,1,0 as shown in the call expansion. In the second call, 
USAGE=U sets UV=1, REWIND=YES (default) sets &RY=1, and the $DMFRM generates 
0,0,0,0,0,1,1,0. 


PRINT FUNCTION: DATE=72304 TIME=074604. 


OPENL MAC LISTING 
00001 MACRO 
00002 &TAG OPENL &IDENT=,&LABDE F=,&REWIND=YES,&USAGE=1,&CONTROL=ANS,&LIST= 
00003 GBLA &DMOCCNT 
00004 ADO &DMOCCNT < EQ>0, .DMOPIO SET GLOBAL FORM 
00005 &DMOCCNT SETA 1 AND EXTERNAL 
00006 EXTRN &DMOCC FIRST TIME 
00007. &DMFRM FORM 1,1,1,1,1,1,1,1 
00008 .DMOPIO ANOP 
00009 ADO K’&TAG <EQ> 0, .DMOP15 SET 6 BYTE 
00010 &TAG1 SETC C’DNM’ TAG FOR LABEL 
00011 &TG SETC &SYSNDX 
00012 AGO -DMOP25 PREFIX ON FIELDS OF 
00013. .DMOP15 ANOP THE LIST 
00014 &TG SETC Cc * 
00015 ADO K’&TAG < LE >6, .DMOP20 
00016 &TAG1 SETC &TAG 
00017 AGO -DMOP25 
00018 .DMOP20 ANOP 
00019 &TAG1 SETC &TAG(1,6) 
00020. .DMOP25 ANOP 
00021 &LY SETA &LIST <EQ>C’'YES’ LIST=YES 
00022 ADO &LY ,.DMOP30 
00023 AGO -DMOP50 
00024 .DMOP30 ANOP 
00025 &LN SETA &LIST< EQ >C’NO’ LIST=NO OR OMITTED 
00026 &TAG LODD OPED&SYSNDX ,@7 SET RETURN INTO SAVE AREA 
00027 ADO &LN, .DMOP40 
00028 BCH @$DMOCC REG 6 ALREADY POINTS TO PACKET 
00029 AGO -MEXIT 
00030 .DMOP40 ANOP 
00031 BSR @$DMOCC,6 SET REG 6 AT PACKET 
00032 AGO -DMOP55 
00033. .DMOPS5O ANOP 
00034 &TAG ALIGN 2 
00035 .DMOP55 ANOP 


Figure F-1. Macro Definition 
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00036 
00037 
00038 
00039 
00040 
00041 
00042 
00043 
00044 
00045 
00046 
00047 
00048 
00049 
00050 
00051 
00052 
00053 
00054 
00055 
00056 
00057 
00058 
00059 
00060 
00061 
00062 
00063 
00064 
00065 
00066 
00067 
00068 
00069 
00070 
00071 
00072 
00073 
00074 
00075 
00076 
00077 
00078 
00079 
00080 
00081 
00082 
00083 
00084 
00085 
00086 
00087 
00088 


* CHANGE MADE PER PTR 333 06/16/72 DJS 


&LB 
&UI 
&UO 
&UU 
&USG 
&RY 
&RN 
&REW 
&CCA 
&CCN 
&CNTRL 
&IDNO 
&ERR 


&ERR 
-DMOP60 


&ERR 
-DMOP65 


&ERR 
-DMOP70 


&ERR 
-DMOP73 


-DMOP75 
&F1 


&TAGI.BT&TG &F1 
&TAG1.ER&TG WDD 


&TAG1.BD&TG WDD 


SETA 
SETA 
SETA 
SETA 
SETA 
SETA 
SETA 
SETA 
SETA 
SETA 
SETA 
SETA 
SETA 
ADO 
MNOTE 
SETA 
ANOP 
ADO 
MNOTE 
SETA 
ANOP 
ADO 
MNOTE 
SETA 
ANOP 
ADO 
MNOTE 
SETA 
ANOP 
ADO 
AGO 
ANOP 
SFTC 
WDD 
BDD 


BDD 
BDD 


BDD 
BDD 
ADO 


K’& LABDEF < GE> 1 SET COUNTERS 
&USAGE< EQ>C’'1' DEPENDING 
&USAGE <EQ>C’'0’ ON ; 
&USAGE<EQ>C’'U’ KEYWORD 
&UI+&U0+&UU NE 1 SPECIFICATIONS 


&REWIND<EQ>C’YES’ 
&REWIND<EQ>C’NO’ 
&RY+&RN<NE >1 
&CONTROL<EQ>C’ANS’ 
&CONTROL<EQ>C’NATIVE’ 
&CCAt&CCN<NE>1 
K’&IDENT<LT>1 

0 

&IDNO, .DMOP60 FATAL IF IDENT MISSING 
F,***IDENT KEYWORD MISSING*** 
1 


&USG, .DMOP65 
F,***USAGE=&USAGE INCORRECT SPECIFICATION *** 
1 


&REW, .DMOP70 
F,***REWIND=&REWIND INCORRECT SPECIFICATION *** 
1 


&CNTRL, .DMOP73 
F,***CONTROL=&CONTROL INCORRECT SPECIFICATION *** 
1 


&ERR, .DMOP75 


MEXIT 

C’&DMERM’ 

“7 LENGTH OF PACKET (WORDS) 

$'04’ OPEN 
&CCN,0,0,0,8U0,&UU,&RY &LB OPTION BITS 

“0 ERROR RETURNED HERE 

X’00’ N/A 

&SYSEG SEGMENT TAG 

&IDENT PIR TO BDT 

‘00’ N/A 

&SYSEG SEGMENT TAG 

&LB, .DMOP80 LABEL PARAMETER 


*#** CHANGE 06/21/72 PIR 4351 DJS 
&TAG1I.LB&TG WOD &LABDEF 


-DMOP80 


AGO 
ANOP 


MEXIT 


**** CHANGE 06/21/72 PTR 4351 DJS 


&TAG1.LB&TG WDD 


MEXIT 


OPED&SYSNDX EQU * 


ANOP 


MEND 


“0 


CODED 
RETURN HERE 


LBINOO10 LIBRARY FUNCTION COMPLETE 


Figure F-1. Macro Definition (Continued) 
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O52E 
0532 


0536 
0538 
0539 


053A 
053C 


053D 
053E 
0540 
0541 


0542 


O5A4 
05A8 


O5AC 
O5AE 
O5AF 
O5B0 
O5B2 
05B3 
O5SB4 
O5B6 
05B7 


C5B8 


BOOF0S44 
EA860000 


BOOFO5BA 
EA860000 


0007 
04 


0224 

0227A 
0228A 
0239A 
0242A 
0245A 
0270A 
0271A 
0272A 
0273A 
0274A 
0275A 
0276A 
0277A 
0278A 
0281A 
0282A 
0284A 


0408 

0420A 
0423A 
0426A 
O0451A 
0452A 
0453A 
0454A 
0455A 
0456A 
0457A 
0458A 
0459A 
0462A 
0463A 
0465A 


$DMFRM 


OPENL 
EXTRN 
FORM 
LODD 
BSR 


IDENT=FILE1 USAGE=0 
&DMOCC 

1,11111171 
OPEDO0002 @7 
@$DMOCC 6 


* CHANGE MADE PER PTR 333 06/16/72 DJS 


DMBTO0002 
DMERO0002 


DMBDO002 


WDD 
BDD 
&DMFRM 
WDD 
BDD 
BDD 
WDD 
BDD 
BDD 


“7 
x’04’ 
0,0,0,0,1,0,1,0 
“0 

X‘00’ 

$SYSEG 
FILE1 

X‘00' 
$SYSEG 


**** CHANGE 06/21/72 PTR 351 DJS 


DMLBO0002 
OPEDOO002 


Figure F-2. Macro Instruction and Expansion (Call 1) 


DMBTO00S 
DMEROO005 


DMBDO0005 


DMLBOO005 
OPEDO0005 


OPENL IDENT=FILE1,USAGE=U 
LODD OPEDO005 ,*7 
BSR @$DMOCC,6 
* CHANGE MADE PER PTR 333 06/16/72 DJS 
WDD “7 
BDD X‘04’ 
&DMFRM — 0,0,0,0,0,1,1,0 
WDD “0 
BDD X’00’ 
BDD $SYSEG 
WDD FILE1 
BDD X‘00’ 
BDD $SYSEG 
**** CHANGE 06/21/72 PTR 351 DJS 
WDD “0 
EQu + 


Figure F-3. Macro Instruction and Expansion (Call 2) 


WDD 
EQU 


“0 


* 


FIRST TIME 


SET RETURN INTO SAVE AREA 
SET REG 6 AT PACKET 


LENGTH OF PACKET (WORDS) 
OPEN 

OPTION BITS 

ERROR RETURNED HERE 
N/A 

SEGMENT TAG 

PTR to BDT 

N/A 

SEGMENT TAG 


RETURN HERE 


SET RETURN INTO SAVE AREA 
SET REG 6 AT PACKET 


LENGTH OF PACKET (WORDS) 
OPEN 

OPTION BITS 

ERROR RETURNED HERE 
N/A 

SEGMENT TAG 

PTR TO BDT 

N/A 

SEGMENT TAG 


RETURN HERE 


G. ASSEMBLER ERROR MESSAGES 


The Assembler issues two types of errors. They are source error diagnostic messages and 
source error abort messages. Also listed in this section are the system messages that cause 
the Assembler to abort. 

ASSEMBLER SOURCE ERROR DIAGNOSTIC MESSAGES 


The assembler source errors are printed at the end of the listing. 


The messages have the following format: 


LINE ERROR ERROR 
NUMBER TYPE CODE MESSAGE TEXT 
nnnn t aappnnn text * insert * text 
where: 
nnnn is a 4-digit decimal number that refers to the line in the 


source listing where the error occurred. 


t is either W designating the error as warning or F desig- 
nating the error as fatal. 


aappnnn is a 7-character error code where aa is always AS 
specifying the Assembler as the source of the error, 
pp is a 2-digit decimal number indicating the pass of 
the Assembler during which the error occurred, and 
nnn is a 3-digit decimal number specifying the error 
within the pass. 


text * insert * text is the text of the message. If the text contains an insert, 
an asterisk precedes and follows the insert. An insert 
contains the erroneous character and all characters back 
to the beginning of the invalid term. For example, if 
the listing contains an invalid variable symbol, such as 
&8PAM, the insert will contain the characters &8. 


The error messages and their explanations follow. 
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LINE 


NUMBER 


nnnan 


Annan 


nannn 


nann 


nnnn 


nnann 


nanan 


nnann 


nnann 


nann 


nnann 


nann 


nnann 


ERROR 


TYPE 


F 


ERROR 
_CODE 


AS02001 


AS02002 
AS02003 


AS02004 


AS02005 


AS02006 


AS02007 


AS02008 


AS02009 


AS02010 


AS02011 


AS02012 


AS02013 


MESSAGE TEXT 


OPERAND SIZE OR NUMBER OF TERMS 
EXCEEDS MAXIMUM. 

This message indicates internal stack overflow. 
To correct the condition, reduce the number 
of terms in the expression or number of 
operands. 


UNMATCHED RIGHT PARENTHESIS. 
UNMATCHED LEFT PARENTHESIS. 


EXPRESSION OR SUBLIST CONTAINS AN 
INVALID COMMA. 


INVALID SYNTAX «. . .insert. . .* 
An invalid element or combination of 
elements appear. 


INVALID USE OF INDIRECTION. 
*,, .Insert. . .* 

The use of the indirect operator, @, is 
invalid. 


INVALID EXPRESSION «.. .insert. . .* 
The syntax does not follow the rules for 
coding expressions. 


INVALID USE OF LITERALS «.. .insert. . .* 
The use of the literal operator, =, is invalid 
in this statement. 


INVALID USE OF PARENTHESIS 
*,. Insert. . .* 


CHARACTER STRING INVALID WITH 
+-* OR / OPERATOR «.. .insert. . .« 
Arithmetic operations are invalid with strings. 


INVALID SUBLIST «. . .insert. . .* 
The use of the sublist is invalid in this 
statement. 


RELOCATABLE TERM USED IN MULTI- 
PLICATION, DIVISION OR LOGICAL 
OPERATION ~«.. .insert. . .* 

The location counter, *, may not enter into 
the above mentioned operations. 


MAY NOT FOLLOW A LOGICAL, RELA- 
TIONAL OR ARITHMETIC OPERATOR 
x, . .Insert. . .* 

The unary operator NOT may not follow 
the above mentioned operators. 


ERROR 
TYPE 


ERROR 


_CODE_ 


MESSAGE TEXT 


AS02014 and AS02015 are reserved for future use. 


AS02024 is reserved for future use. 


LINE 

NUMBER 

NOTE: 
nnnn F 
nnnn F 
nnnn F 
nnnn F 
nnnn F 
nnnn F 
nnnn F 
nnnn F 

NOTE: 
nnnn F 
nnnn W 
nnnn W 


AS02016 


AS02017 


AS02018 


AS02019 © 


AS02020 


AS02021 


AS02022 


AS02023 


AS02025 


AS02026 


AS02027 


SYMBOL TOO LONG «.. .insert. . .* 
The name entry or a symbolic operand 
may not exceed 8 characters. 


INVALID HEXADECIMAL CONSTANT 
*,. insert. ..* 

A hexadecimal constant may only contain 
digits 0-9 and characters A-F. 


OPERAND SIZE OR NUMBER OF TERMS 
EXCEEDS MAXIMUM «.. .insert. . .* 

This message indicates internal stack over- 
flow. To correct the condition, reduce the 
number of terms in the expression or the 
number of operands. 


INVALID OPERATOR «.. .insert. . .* 
The operator or symbol is not in the 
language. 


INVALID CHARACTER «.. .insert. . .* 
The character is not in the language or is 
contextually incorrect. 


INVALID CONTINUATION «.. .insert. . .* 
The usage of the semicolon is contextually 
invalid. 


INVALID SYMBOL «.. .insert. . .* 
The length attribute operand may only be 
symbolic. 


INVALID STRING «.. .insert. . .* 
An invalid string structure appeared. 


INVALID STRING *. . .insert. . .* 
Same as AS02023 above. 


OPERAND TRUNCATED — TOO LONG 
*,. insert. ..* 

The number of digits exceeds the maximum 
allowed. For a decimal integer, 5 is the maxi- 
mum. For an integer string, 10 is the maxi- 
mum. For a hexadecimal constant, 4 is the 
maximum. 


VALUE TRUNCATED — EXCEEDS PER- 
MISSIBLE MAGNITUDE «.. .insert. . .* 

A decimal integer may not exceed 65,535. 

An integer string may not exceed 268,435,455. 


LINE 


NUMBER 


nnann 


nnann 


nnnn 


nnann 


nnann 


nnnn 


nnann 


nnnn 


nann 


nnann 


nnnn 


nnnn 


nnann 


nnnn 


ERROR 


TYPE 


F 


ERROR 


CODE 


AS02028 


AS02029 


AS02030 


AS02031 


AS02032 


AS02033 


AS02034 


AS02035 
AS02036 


AS02037 


AS02038 


AS02039 


AS02040 


AS02041 


MESSAGE TEXT 


OPERAND ENTRY MISSING. 
The operation code in this statement 
requires an operand field entry. 


CONTINUATION LINE IS BLANK. 


TOO MANY CONTINUATION STATEMENTS. 
In a normal statement, only one continued 
statement is allowed. 


VARIABLE SYMBOL MUST START WITH & 
FOLLOWED BY A-Z OR §. 


LEFT PARENTHESIS MAY NOT BE 
IMMEDIATELY PRECEDED BY A 
VARIABLE SYMBOL. 


VARIABLE SYMBOL MUST START WITH & 
FOLLOWED BY A-Z OR §. 


VARIABLE SYMBOL TOO LONG. 
The variable symbol is greater than 7 characters 
excluding the ampersand sign. 


.* COMMENT VALID ONLY WITH A MACRO. 


CHARACTER THAT FOLLOWS .OR & MUST 
BE A-Z OR §. 

Period or & is followed by a numeric or an 
illegal character in the name field. 


NAME ENTRY TOO LONG. 
In an ordinary symbol, only 8 characters are 
allowed and in a sequence or variable symbol 
only 7 characters are allowed. 


INVALID CHARACTER IN NAME ENTRY. 
Only characters allowed are A-Z, 0-9 and $. 
For a sequence or variable symbol, the first 
character must be . or & respectively. 


OPERATION ENTRY MISSING. 
An operation entry is required in every state- 
ment. 


NAME ENTRY CANNOT BE CONTINUED. 


NAME ENTRY MUST BE FOLLOWED BY A 
SPACE. 

The space is the delimiter of each field in the 
MRX Assembler. 


LINE ERROR ERROR 


NUMBER TYPE CODE MESSAGE TEXT | 
nnnn F AS02042 OPERATION ENTRY MUST BE FOLLOWED 
BY A SPACE. 


The space is the delimiter of each field in the 
MRX Assembler. 


nnnn F AS02043 OPERATION CODE CANNOT BE CONTINUED. 
nnnn F AS02044 ~ INVALID CHARACTER IN OPERATION 
ENTRY. 


Only valid characters are A-Z, 0-9, & and $. 


nnnan F AS02045 OPERATION ENTRY TOO LONG. 
Only 8 characters are allowed if there is no 
substitution in the operation entry. 


nnnn W AS02046 INVALID ISEQ PARAMETERS — COMMAND 
; IGNORED. 
1. The parameter value is within the begin 
and end limits in the statement. 
2. The length of the sequence field is zero. 
3. The length of the sequence field is greater 
than 8 characters. 


nnnn W AS02047 MISPLACED ICTL STATEMENT. 
An ICTL statement must be the first statement 
of an assembly. 


nnnan Ww AS02048 STATEMENT VALID ONLY WITHIN A 

MACRO. 
The following operation codes are allowed 
within a macro definition: 

GBLA 

GBLC 

MACRO 

MEND 

MNOTE 

MEXIT 


nnnn W AS02049 INVALID OR MISPLACED INSTRUCTION IN 
MACRO DEFINITION. 
The following operation codes are not allowed 
within a macro definition: 
PRINT 
ISEQ 
MACRO 
Also GBLA, GBLC must immediately follow the 
- macro definition prototype. 


nnnn F AS02051 INVALID CONTINUATION. 


The continued statement has a continuation 
character as the first nonblank character. 
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Bulletin: 2202.001-0101 


Date: 3/19/73 


LINE 


NUMBER 


nnnan 


nann 


nann 


nnnn 


nann 


nnnn . 


nann 


nnann 


nnnan 


nnann 


nnnan 


-Annn 


nann 


nnnan 


nann 


ERROR 


TYPE 


Ww 


Ww 


ERROR 


CODE 


AS02052 


AS02053 


AS02054 


AS02055 


AS02056 


AS02057 


AS02058 


AS02059 


AS02060 


AS02061 


AS02062 


AS02063 


AS02064 
AS02065 


AS02066 


MESSAGE TEXT 


END STATEMENT SUPPLIED BY ASSEMBLER. 
End of input detected but no end card received. 


NAME FIELD OF MEND STATEMENT MAY 
ONLY CONTAIN A SEQUENCE SYMBOL. 


NAME FIELD OF MACRO DEFINITION 
HEADER MUST BE BLANK. 

The name of the operation code MACRO 
must be blank. 


REQUIRED OPERAND ENTRY MISSING. 
The operation code in the statement requires 
an operand field entry. 


SYMBOLIC PARAMETER CANNOT BE 
USED AS A GBLA OR GBLC OPERAND. 


SET SYMBOL MAY NOT BE DEFINED AS 
BOTH SETA AND SETC. 


INVALID SYNTAX MATCHING QUOTE MISSING. 


MACHINE AND ASSEMBLER OPERATION 
CODES MAY NOT BE USED AS MACRO 
INSTRUCTION. 


MULTIPLE DEFINITION OF MACRO 
INSTRUCTION. 
Macro instruction has been previously defined. 


NAME ENTRY OF MACRO PROTOTYPE 
STATEMENT MUST BE BLANK ORA 
VARIABLE SYMBOL. 


MORE THAN 35 SYMBOLIC PARAMETERS. 
Only 35 symbolic parameters are allowed. 


NAME ENTRY OF MACRO INSTRUCTION 
MAY NOT BE A VARIABLE SYMBOL. 


STATEMENT OUT OF SEQUENCE. 


INVALID ISEOQ SYNTAX. 

In an ISEQ statement the name entry must be 
blank and the parameters must be separated by 
a comma and must be terminated by a space. 


INVALID ICTL SYNTAX. 
In an ICTL statement the name entry must be 
blank. 


LINE 


NUMBER 


nnnn 


nnann 


nnann 


nann 


nnann 
nann 
nann 


nnnn 


Annan 


nnnn 


nann 


ERROR 
TYPE 


Ww 


W or F 


ERROR 


CODE 


AS02067 


AS02068 


AS02069 


AS02070 


AS02071 
AS02072 
AS02073 


AS02074 


AS02075 


AS02076 


AS02077 


MESSAGE TEXT 


NAME FIELD OF GBLA AND GBLC 
STATEMENTS MUST BE BLANK. 


OPERAND SYNTAX ERROR. 

An invalid character is in the operand field 
or invalid termination of a sublist, etc., 
appears in the operand field. 


OPERAND LENGTH ERROR. 
The maximum number of characters allowed 
per operand is 127. 


MORE THAN 35 OPERANDS. 

Only 35 operands are allowed in a macro 
prototype or a GBLA or GBLC statement or 
a macro definition instruction statement. 


NAME ENTRY MAY NOT BE A SEQUENCE 
SYMBOL. 


NAME FIEL D MUST CONTAIN A SET 
SYMBOL. 


SET SYMBOL MAY NOT BE DEFINED AS 
BOTH SETA AND SETC. 


MNOTE «.. insert. . .* 

An MNOTE Assembler instruction has been 
encountered. The MNOTE message is output 
to the error file and processing continues. 


VALUE OF OPERAND EXCEEDS 65535. 

A number being converted from EBCDIC to 
binary has a value greater than +65535. The 5 
least-significant digits are converted to binary 
and only the least-significant 16 bits of the 
result are retained. 


INVALID ADO EXPRESSION. 

The expression in the operand field of this 
ADO instruction did not resolve to an 
integer of value between 0 and 65535. The 
ADO statement is not processed. 


IMPROPER ADO TERMINATION. 

1. The sequence symbol in the name field 
of this ADO statement terminates the 
currently active ADO loop. The currently 
active ADO loop is unstacked and the 
ADO statement is not processed. 


LINE 


NUMBER 


nnann 


nnnan 


nnnn 


nnnn 


nnann 


ERROR 
TYPE 


ERROR 
CODE 


AS02078 


AS02079 


AS02080 


AS02081 


AS02082 


MESSAGE TEXT 


2. |The sequence symbol! in the name field 
of this macro instruction terminates the 
currently active ADO loop. The 
currently active ADO loop is unstacked. 

3. AMEXIT or MEND instruction has been 
encountered, and the currently active 
ADO loop is at the current macro nesting 
level. The currently active ADO loop is 
unstacked. 


SECOND ADO OPERAND MISSING. 
The sequence symbol is missing from the 
operand field of this ADO statement. The 
ADO statement is not processed. 


BACKWARD BRANCH IN ADO OR AGO. 
The statement which contains the sequence 
symbol referred to in this ADO or AGO 
statement precedes the current statement. 
The ADO or AGO statement is not 
processed. 


INVALID CONTINUATION. 

1. Substitution into a source statement 
cannot be completed without generating 
more than one continuation line. Sub- 
stitution is discontinued. 

2. Substitution into a form reference 
cannot be completed without generating 
more than one continuation line. The 
statement is not processed. 


DUPLICATE DEFINITION OF VARIABLE 

SYMBOL. 

1. A-variable symbol defined in a macro 
instruction is already in the local symbol 
table at the current macro nesting level. 

2. &SYSECT or &SYSNDX is already in the 
local symbol table at the current macro 
nesting level. 

The value already in the symbol table is 

retained. 


DUPLICATE FORM DEFINITION. 

More than one definition was encountered 
for the current form. The form definition 
is dropped. 


LINE ERROR ERROR 


NUMBER TYPE CODE MESSAGE TEXT 
nnnn F AS02083 INVALID SEQUENCE SYMBOL. 


1. Sequence symbol does not start with a 
period followediby a letter or $. 

2. Sequence symbol is not 1-8 characters 
followed by a space. 

The instruction is replaced with ERR. 


nnnn F AS02084 - INVALID FORM SYNTAX. 
The form reference contains a keyword 
parameter or a sublist parameter. The form 
reference is dropped. 


nnnn F AS02085 UNDEFINED SET SYMBOL OR SYMBOLIC 

PARAMETER. 

1. Set symbol or symbolic parameter is 
not found in symbol table. Substitute 
null value for missing value. 

2. Global set symbol is not found in 
symbol table. The ADO statement is 
not processed. 

3. Global set symbol is not found in 
symbol table. The SETA or SETC 
statement is not processed. 


nnnn F AS02086 INVALID SUBSTITUTION OF SEMICOLON. 
The first character of the value assigned to a 
variable symbol is a semicolon, and the 
character which would immediately precede it 
in the substitution record is not an escape 
character (_ ). Substitute null for the value. 


nnnn F AS02087 UNDEFINED MACRO. 

; 1. The operation code in a statement 
created by substitution is neither an 
ordinary instruction nor a form 

_ instruction. 
2. The operation code in this statement 
is neither an ordinary instruction nor 
a form instruction, nor can it be found 
in the macro library. 
The instruction is replaced by ERR. 


nnnn F AS02088 INVALID NAME ENTRY. 

1. Symbol in the name field of record 
created by substitution is either too 
long or contains an invalid character. 

2. Name field of form definition is either 
an instruction mnemonic or it is not an 
ordinary symbol. 
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LINE ERROR ERROR 
NUMBER TYPE CODE MESSAGE TEXT 


3. Statement has nonblank name field. 

4. Statement has nonblank name field 
which is not a sequence symbol. 

5. Statement has nonblank name field 
which is not an ordinary symbol or 
a sequence symbol. 

6. Name field of ADO statement contains 
an ordinary symbol. 

7. Name field of SETA statement does not 
contain a SETA symbol. 

8. Name field of a SETC statement does 
not contain a SETC symbol. 

For conditions 1, 3, 4, 5, and 6, the name 

field is ignored. For condition 2, form 

definition is not processed. For conditions 

7 and 8, SETA and SETC statements are 

not processed. 


nnonn F AS02089 ADO OR AGO OPERAND MUST BEA 
SEQUENCE SYMBOL. 
The ADO or AGO statement is not processed. 


nnnan F AS02090 &SYSNDX NOT IN SYMBOL TABLE. 
Assembler logic error. The SETA and SETC 
statement is not processed. 


nnnn F AS02091 MORE THAN FIVE LEVELS OF MACRO 
NESTING. 
The instruction is replaced by ERR. 


nnnn F AS02092 OPERAND LENGTH ERROR. 
Length of operand or suboperand exceeds. 
127 bytes. The operand is replaced by null. 


nnnn F AS02093 TOO MANY OPERANDS. 

1. |More operands are in a macro call than 
there are parameters in the prototype. 

2. AGO, SETA, or SETC statement 
contains more than one operand. 

3. ADO statement contains more than 
two operands. 

The extra operands are ignored. 


nnnn F AS02094 MACRO DEFINITION ERROR. 
Macro instruction is replaced by ERR. 


nnnn F AS02095 TOO MANY LEVELS OF ADO NESTING. 
The ADO statement is not processed. 


G-10 


LINE ERROR ERROR 


NUMBER TYPE CODE MESSAGE TEXT 
nnnn oF AS02096 INNER ADO LOOP MUST BE COMPLETELY 
CONTAINED WITHIN THE OUTER ADO 
LOOP. 


Processing of the outer ADO loop is discontinued. 


nnnn W AS02097 INVALID PRINT OPERAND. 

1. |The operand field is terminated by a comma 
or semicolon. 

2. One of the operands is not “OFF, ON, 
NOGEN, GEN, NODATA, DATA, 
NOCOND, OR COND.” 

The remainder of the operand is ignored and the 

assembly process continues, using the last valid 

operand processed for each option. 


nnnn F AS02098 MACRO INSTRUCTION MAY NOT HAVE 
BOTH POSITIONAL AND KEYWORD 
PARAMETERS. 
The macro instruction is not processed. 


nnnn F AS02099 MACRO INSTRUCTION USED AS FORM 
NAME. 
The name field of a form definition which 
was created by substitution contains a 
mnemonic that has been identified as a 
macro instruction. The form definition 
is not processed. 


nnnn F AS02100 INVALID SET EXPRESSION. 

1. |The operand field of SETA instruction 
contains a nonnumeric character. 

2. The value of aSETA expression exceeds 
65,535. 

3. The operand field of aSETA or SETC 
instruction contains a sublist or a 
sequence symbol. 

The SETA or SETC instruction is not processed. 


nnnn F AS02101 REFERENCE TO UNDEFINED SET SYMBOL. 
This is an Assembler logic error. 


nnnn F AS02102 INVALID SUBSTITUTION. 

1. ‘The symbol whose value is to be used in 
substitution is not a SETA, aSETC, a 
symbolic parameter, or &SYSNDX. This 
is an Assembler logic error. The value is 
replaced by null. 

2. The name field of a statement created by 

substitution contains a sequence symbol. 
The name field of the statement is ignored. 


LINE 


NUMBER 


Aannn 


nnnn 


nnan 


nnann 


nnann 


nann 


nann 


nnnn 


ERROR 


TYPE 


F 


ERROR 


CODE 


AS02103 


AS02104 


AS02105 


AS02106 


AS02107 


AS02108 


AS02109 


AS02110 


MESSAGE TEXT 


REFERENCE TO &SYSNDX VALID ONLY 
WITHIN A MACRO. 
The SETA or SETC statement is not processed. 


REFERENCE TO UNDEFINED FORM. 
Reference to a form instruction whose definition 
has not yet appeared in the generated source. 
The instruction is replaced by ERR. 


ae KEYWORD OPERAND. 
The macro instruction has more operands 
than the macro prototype has parameters. 
2. The macro instruction has at least one 
operand whose name does not match any 
of the prototype’s keyword parameters. 
The extra operands are ignored. 


REFERENCE TO UNDEFINED SEQUENCE 
SYMBOL. 
The ADO or AGO statement is not processed. 


INVALID SUBSTITUTION INTO OPERATION 
ENTRY. 

The instruction in this substitution record was 
one which may not be created by substitution. 
The instruction is not processed. 


MORE THAN 35 SUB-OPERANDS. 
This is an Assembler logic error. 


OPERATION ENTRY MISSING. 

1. The statement created by substitution is 
all blank after the name field. 

2. The statement created by substitution 
has a continuation character immedi- 
ately after the name field. 

The instruction is replaced by ERR. 


INVALID OPERATION ENTRY. 


1. The operation code in the statement 


created by substitution is more than 
eight characters long. 

2. The operation field in the statement 
created by substitution contains an 
invalid character. 

3. The operation code in the statement 
created by substitution is continued 
on the second line of the statement. 

The instruction is replaced by ERR. 


LINE 
NUMBER 


nnann 


nnnn 


nnnn 


NOTE: 

nnnn 
NOTE: 

nnnn 
NOTE: 
NOTE: 
NOTE: 


nnnn 


nann 
nnnan 


nnann 


nnnan 


nanan 


nnnan 
nannn 


nnrn 


W 


AS02115 reserved for future use. 


F 


AS02117 reserved for future use. 


F 


AS02119 reserved for future use. 


AS02120 reserved for future use. 


ERROR 


CODE 


AS02111 


AS02112 


AS02114 


AS02116 


AS02118 


MESSAGE TEXT | 


REFERENCE TO DOUBLY-DEFINED - 
SEQUENCE SYMBOL. 
The ADO or AGO statement is not processed. 


INSTRUCTION NOT VALID AFTER SEG 
STATEMENT. 
The instruction is not processed. 


SPECIFIED SUBSTRING — LENGTH TOO 


LARGE. 


INVALID USE OF SEQUENCE SYMBOL. 


INVALID USE OF CHARACTER STRING. 


AS02121 and AS02122 reserved for future use. 


F 


AS02123 . 


AS02124 
AS02125 
AS02126 


AS02127 


AS03001 


AS03002 
AS03003 
AS03004 


EXPRESSION CONTAINS INCOMPATIBLE 
OPERAND TYPES. 


EVALUATOR — STACK OVERFLOW. 
MULTIPLICATION OR DIVISION OVERFLOW. 


UNDEFINED SEQUENCE SYMBOL OR 
VARIABLE SYMBOL. 


INVALID SUBSTRING OR SUBLIST 
REFERENCE. 


OPERAND SIZE OR NUMBER OF TERMS 
EXCEEDS MAXIMUM. 

This message indicates internal stack overflow. 
To correct the condition, reduce the number 
of terms in the expression or number of oper- 
ands. 


UNMATCHED RIGHT PARENTHESIS. 
UNMATCHED LEFT PARENTHESIS. 


EXPRESSION OR SUBLIST CONTAINS AN 
INVALID COMMA. 


Bulletin: 2202.001-0101 
Date: 3/19/73 


LINE 


ERROR 


NUMBER TYPE 


nnnan 


nann 


AnnN 


nanan 


nnann 


nnnn 


nnann 


nnann 


nann 


NOTE: 


nnann 


nanan 


ERROR 


CODE 


AS03005 


AS03006 


AS03007 


AS03008 


AS03009 


AS03010 


AS03011 


AS03012 


AS03013 


MESSAGE TEXT 


INVALID SYNTAX *... insert... * 
The lexical or contextual syntax is invalid. 


INVALID USE OF INDIRECTION 
*,..insert. . .* 
The use of the indirect operator, @, is invalid. 


INVALID EXPRESSION «.. .insert. . .* 


The syntax does not follow the rules for 
coding expressions. 


INVALID USE OF LITERALS «.. .insert. . .* 
The use of the literal operator, =, is invalid in 
this statement. 


INVALID USE OF PARENTHESIS 
*.. insert. . .* 


CHARACTER STRING INVALID WITH 
+-* OR / OPERATOR «.. .insert. . .* 
Arithmetic operations are invalid with strings. 


INVALID SUBLIST «.. .insert. . .* 
The use of the sublist is invalid in this 
statement. 


RELOCATABLE TERM USED IN MULTI- 
PLICATION, DIVISION OR LOGICAL 
OPERATION «.. .insert. . .* 

The location counter, *, may not enter into 
the above mentioned operations. 


MAY NOT FOLLOW A LOGICAL, RELA- 
TIONAL OR ARITHMETIC OPERATOR 

*, insert. . .* 

The unary operator NOT may not follow the 
above mentioned operators. 


AS03014 and ASO3015 are reserved for future use. 


F 


AS03016 


AS03017 


SYMBOL TOO LONG «.. .insert. . .* 
A name entry or a symbolic operand may not 
exceed 8 characters. 


INVALID HEXADECIMAL CONSTANT 
*,..insert. . .* 

A hexadecimal constant may only contain 
digits 0-9 and characters A-F. 


G-14 


LINE 


NUMBER 


nnan 


nnnan 


nann 


nnnn 


nnnn 


nann 


nnann 


nnnn 


nnnan 


nann 


Aannn 


ERROR 
TYPE 


F 


ERROR 


CODE 


AS03018 


AS03019 


AS03020 


AS03021 


AS03022 


AS03023 


AS03024 


AS03025 


AS03025 


AS03026 


AS03027 


Bulletin: 2202.001-0101 
Date: 3/19/73 


MESSAGE TEXT 


OPERAND SIZE OR NUMBER OF TERMS 
EXCEEDS MAXIMUM «.. .insert. . .* 

This message indicates internal stack overflow. 
To correct the condition, reduce the number 
of terms in the expression or the number of 
operands. 


INVALID OPERATOR «.. .insert. . .* 
The operator or symbol is not in the language. 


INVALID CHARACTER «.. .insert. . .* 
The character is not in the language or is 
contextually incorrect. 


INVALID CONTINUATION «.. .insert. . .* 
The usage of the semicolon is contextually 
invalid. 


INVALID SYMBOL «.. .insert. . .* 
The length attribute operand may only be 
symbolic. 


INVALID STRING «.. .insert. . .* 
An invalid string structure appeared. 


INVALID STRING *...insert...* 
Same as AS03023 above. 


FLOATING-POINT CONSTANT *...insert...* 
OVER/UNDERFLOW 

The explicitly coded exponent or the value 
exceeds permissible magnitude. An 8-byte 
floating point zero is generated. 


INVALID STRING «.. .insert. . .* 
Same as AS03023 above. 


OPERAND TRUNCATED — TOO LONG 
*,..insert.. .* 

The number of digits exceeds the maximum 
allowed. For a decimal integer, 5 is the 
maximum. For an integer string, 10 is the 
maximum. For a hexadecimal constant, 4 

is the maximum. 


VALUE TRUNCATED — EXCEEDS PER- 
MISSIBLE MAGNITUDE «.. .insert. . .* 

A decimal integer may not exceed 65,535. 

An integer string may not exceed 4,294,967,295. 


NOTE: AS03028 and AS03029 are reserved for future use. 


nann 


Ww 


AS03030 


INVALID USE OF NAME ENTRY. 
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LINE ERROR ERROR 
NUMBER TYPE CODE 
nnnn F AS03031 
nnnn F AS03032 
nnnn F AS03033 
nnnan F AS03034 
nnnn F AS03035 
nnnn F AS03036 
nnnn F AS03037 
NOTE: AS03038 is reserved for future use. 
nnnn F AS03039 
nnnn F AS03040 
nnnn F AS03041 
NOTE: AS03042 is reserved for future use. 


MESSAGE TEXT 


INVALID FORM DEFINITION. 
A form reference cannot be used as an operand 
entry. 


INVALID USE OF $SYSEG. 
$SYSEG is invalid in an evaluated expression. 


RELOCATABLE TERM INVALID WITH 
UNARY OPERATOR. 

A relocatable term may not be used in con- 
junction with a NOT operator. 


INVALID USE OF STRING CONSTANT. 
A string constant may not be used as a term 
in conjunction with an arithmetic or logical 
operator. 


RELOCATABLE TERM INVALID WITH */ 
OR LOGICAL OPERATOR «.. .insert. . .+ 
A relocatable term may not be used in con- 
junction with a multiplication, division, or 
logical operation. 


INVALID SYNTAX. 
The operand structure does not follow the 
rules of the language. 


MORE THAN SIX RELOCATABLE TERMS. 
An expression may not contain more than six 
unresolved relocatable terms. 


INVALID STRING «.. .insert. . .* 
Both strings in a relational or logical operation 
must be the same type. 


OPERAND SIZE OR NUMBER OF TERMS 
EXCEEDS MAXIMUM «.. .insert. . .* 
The expression size is too large to be evaluated. 


MULTIPLICATION OR DIVISION OVER- 
FLOW +*...insert...* 

Either division overflow has occurred or the 
second term of a multiplication or division 
operation exceeds a 16-bit value. 


AS03045 is reserved for future use. 


ERROR 


CODE 


AS03043 


AS03044 
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MESSAGE TEXT 


RELOCATABLE TERM INVALID WITH 
RELATIONAL OPERATOR ~+.. .insert. . .* 
A relocatable term may not be used in con- 
junction with a relational operator. 


UNDEFINED SYMBOLIC OPERAND. 
The reference is not used as a label within 
this program. 


AS03046 through AS03050 are reserved for future use. 


AS03055 is the same as AS03052. 


AS03051 


AS03052 


AS03053 


AS03054 


DUPLICATE ENTRY OF ASYMBOLIC 
DEFINITION *.. .insert. . .* 

The name field entry definitions must be 
unique. All duplicates are discarded. 


ENTRY POINT DEFINITION IS NOT 
RELOCATABLE «.. .insert...* 

The entry point definition must resolve 
to a relocatable term. 


CSECT NAME IS ALREADY DEFINED, 
BUT NOT AS CSECT +.. .insert. . .* 
Control section names must not appear as 
ordinary name field entries. 


COM NAME IS ALREADY DEFINED, 
BUT NOT COM «...insert...* 

COM names must not appear as ordinary 
name field entries. 


AS03056 through AS03058 are reserved for future use. 


LINE ERROR 
NUMBER TYPE _ 
nnnn F 
nnnn F 
NOTE: 
NOTE: 
nnnn F 
nann F 
nnnn F 
nann F 
NOTE: 
NOTE: 
nnnn F 
‘annn F 
nnann F 


AS03059 


AS03060 


AS03061 


DUPLICATE FORM DEFINITION. «.. insert... 


The form definition name entry is previously 
defined. 


INVALID SYNTAX IN STORAGE 
RESERVATION. 

The operand of a reserve storage instruction 
must be preresolved, absolute, positive arithme 


tic expression. Only one operand is allowed. 


INVALID SYNTAX IN DATA DEFINITION. 
The syntactical structure of the data definition 
operand ts invalid. 


ERROR 


“CODE 


AS03062 


AS03063 


AS03064 


AS03065 


AS03066 


AS03067 


MESSAGE TEXT 


INVALID USE OF INDIRECTION. 
An indirect operator is invalid in data 
definition operands. 


INVALID USE OF LITERAL. 
The litera! operator is invalid in size or 
repetition field of a data definition operand. 


INVALID SIZE SPECIFICATION. 
The size operand of data definitions must 
be preresolved absolute expression. 


INVALID REPETITION FACTOR. 

The repetition factor of a data definition 
operand must be a preresolved absolute 
expression. 


VAL UE OF LOCATION COUNTER 
EXCEEDS 65,535. 


TRUNCATION OCCURRED. 

The implied size of the value operand is 
greater than the explicit size operand ina 
data definition. 


AS03068 through AS03069 are reserved for future use. 


LINE ERROR 
NUMBER TYPE 
nnnn F 
nnnn F 
nnnn F 
nnnn F 
nnnn F 
nnnn W 

NOTE: 
nnnn F 
nnnn F 
nnnn F 
nnnn F 
nnnn F 


AS03070 


AS03071 


AS03072 


AS03073 


AS03074 


INVALID USE OF $SYSEG. 
The data following $SYSEG definition must 
be two bytes long, word aligned, and relocatable. 


REQUIRED OPERAND ENTRY MISSING. 
This instruction requires an operand and none 
was supplied. 


INVALID SUBLIST. 
The syntax indicates a suboperand, but the 
instruction does not allow suboperands. 


INVALID USE OF LITERAL. 
The instruction does not allow a literal as an 
operand, but one was coded. 


INVALID USE OF INDIRECTION. 
The instruction does not allow indirection, 
but indirection was coded. 


LINE ERROR ERROR 


NUMBER TYPE CODE MESSAGE TEXT 
nnnn F AS03075 INVALID EXPRESSION. 


The expression coded does not fall within the 
types allowed. 
A string type was used where only 
arithmetic type expressions are allowed. 
2. Anunresolved expression was coded on 
an instruction which required expressions 
to be predefined. 
3. A-relocatable expression is coded where 
only absolute are allowed. 


nnnn Ww AS03076 NAME FIELD OF ORG STATEMENT MAY 
ONLY CONTAIN A SEQUENCE SYMBOL. 


nnnn W AS03077 INVALID RELOCATION. 
1. An absolute value was coded where a 
relocatable value was required. 
2. Therelocation identifier does not 
match the relocation identifier for the 
control section in effect; e.g., trying to 
~ ORG to another CSECT or COM section. 


nnnn F AS03078 NAME ENTRY REQUIRED ON AN EQU 
STATEMENT. — 
nnnn Ww AS03079 TOO MANY OPERANDS. 


More than the maximum number of operands 
allowable for this instruction were coded. The 
values of the first operands were used. 


nnnn F AS03080 ONLY SINGLE TERM RELOCATABLE 
EXPRESSIONS ARE VALID. 


nnnn F AS03081 COMBINED CSECT, COM AND EXTRN 
| COUNT EXCEEDS 252. 
The binary generated will probably not be 
useless. Reduce the number of EXTERNs 
and CSECTs and COMs and reassemble. 


nnnn W AS03082 INVALID NAME ENTRY. 
The name entry was coded where none was 
allowed. The name entry has not been entered 
into the symbol table. Any reference to it will 
result in an undefined reference. 


nnnn F AS03083 REFERENCE TO INVALID FORM DEFINITION. 
1. The operation entry matches something other 
than a FORM definition. 
2. There was no such entry. 
3. No operand was coded on the reference. 
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LINE 


NUMBER 


nnnn 


nnann 


noann 


nnann 


nnann 


nnann 


nanan 


nann 


nann 


Annan 


nnann 


nnann 
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ERROR 


ae 


FE 


ERROR 


CODE 


AS03084 


AS03085 


AS03086 


AS03087 


AS03088 


AS03089 


AS04001 


AS04002 


AS04003 


AS04004 


AS04005 


AS04006 


MESSAGE TEXT 


OPERAND SIZE EXCEEDS 255 BITS. 

A FORM definition was coded with an operand 
which did not resolve to an absolute value less 
than 255. 


DUPLICATE ENTRY OF A SYMBOLIC 
DEFINITION. 


NAME ENTRY REQUIRED ON A FORM 
DEFINITION. 


CSECT OR COM NAMES MAY NOT 
DUPLICATE ANOTHER NAME. 

The name entries of CSECT and COM state- 
ments cannot duplicate each other or other 
symbols in the same assembly. 


ONLY ONE TITLE STATEMENT INA 
PROGRAM MAY HAVE A NONBLANK 
NAME FIEL D. 


INVALID PRIME ENTRY POINT. 

1. The operand of an END statement does 
not resolve to an even boundary. 

2. The operand does not reference a 
relocatable value. 


INVALID FORM DEFINITION. 
A form reference cannot be used as an operand 
entry. 


INVALID USE OF $SYSEG. 
$SYSEG is invalid in an evaluated expression. 


RELOCATABLE TERM INVALID WITH 
UNARY OPERATOR. 

A relocatable term may not be used in 
conjunction with a NOT operator. 


INVALID USE OF STRING CONSTANT. 
A string constant may not be used as a term 
in conjunction with an arithmetic or logical 
operator. 


RELOCATABLE TERM INVALID WITH */ 
OR LOGICAL OPERATOR «.. .insert. . .* 

A relocatable term may not be used in conjunc- 
tion with a multiplication, division, or logical 
operation. 


INVALID SYNTAX. 
The operand structure does not follow the rules 
of the language. 
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LINE ERROR ERROR | 
NUMBER TYPE CODE MESSAGE TEXT 


nnnn F AS04007 MORE THAN SIX RELOCATABLE TERMS. 
An expression may not contain more than six 
unresolved relocatable terms. 


NOTE: AS04008 is reserved for future use. 


nnnn F AS04009 INVALID STRING +*.. .insert. . .* 
Both strings in a relational or logical operation 
must be the same type. 


nnnn F AS04010 OPERAND SIZE OR NUMBER OF TERMS 
EXCEEDS MAXIMUM +.. .insert. . .* 
The expression size is too large to be evaluated. 


nnnn F AS04011 MULTIPLICATION OR DIVISION OVERFLOW 
*.. insert. ..* 


Either division overflow has occurred or the 
second term of a multiplication or division 
operation exceeds a 16-bit value. 


NOTE: AS04012 is reserved for future use. 


nnnn F — AS04013 RELOCATABLE TERM INVALID WITH 
RELATIONAL OPERATOR ~«.. .insert. . .* 
A relocatable term may not be used in conjunction 
with a relational operator. 


nnnn F AS04014 UNDEFINED SYMBOLIC OPERAND. 
The reference is not used as a label within this 
program. 


NOTE: AS04015 reserved for future use. 


nnnn W AS04016 TRUNCATION OCCURRED. 
The value coded exceeded the match field on a 
FORM definition. Normal rules of truncation 
are followed. 


nnnn W AS04017 TOO MANY OPERANDS. 


nnnn W AS04018 REQUIRED OPERAND ENTRY MISSING. 
Fewer operands were coded in a form reference 
than were coded in the FORM definition. 


nnnn F AS04019 INVALID RELOCATION-VALUE TREATED 
AS ABSOLUTE. 
1. The receive field was not 16 bits or was 
not on an even byte boundary. The number 
of relocation identifiers was greater than one. 
2. For $SYSEG, the receive field was not 8 bits 
long, or was not on a byte boundary. 
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LINE 


NUMBER TYPE 


nnann 


NOTE: 


nann 


nanan 


nannn 


NOTE: 


nann 


nnnAn 


nvann 


NOTE: 


nnnan 


nann 


nnann 


ERROR 


F 


AS04021 is reserved for future use. 


Ww 


Ww 


Ww 


AS04025 is reserved for future use. 


Ww 


AS04029 is reserved for future use. 


Ww 


ERROR 


CODE 


AS04020 


AS04022 


AS04023 


AS04024 


AS04026 


AS04027 


AS04028 


AS04030 


AS04031 


AS04032 


MESSAGE TEXT 


INVALID SYNTAX. 

The syntax of a FORM reference operand may 
have had one of the following errors: 

1. Indirection coded 

2. A sublist coded 

3. No operand was coded. 


TITLE OPERAND MUST BE A CHARACTER 
STRING. 


LENGTH OF TITLE OPERAND EXCEEDS 90 
CHARACTERS. 

The operand is truncated on the right to 90 
bytes and then used. 


SPACE OPERAND MUST BE A RESOLVED 
ARITHMETIC EXPRESSION. 


FORWARD REFERENCE TO STRING EQUATE 
— IMPLICIT STRING — LENGTH IS 2 BYTES. 
A data definition operand referencing a forward 
string equate is implicitly resolved to two bytes. 
Truncation or padding may have occurred. 


TRUNCATION OCCURRED. 
The implicit size of the value operand is greater 
than the explicit size operand in data definitions. 


INVALID RELOCATION — VALUE TREATED 
AS ABSOLUTE. 

A relocatable value must be on word boundary 
and two bytes in length. The number of relocation 
factors in an expression must be resolved to one. 


NOP SUBSTITUTED FOR INVALID 
OPERATION CODE. 


TOO MANY OPERANDS OR SUBOPERANDS. 
Refer to the MRX/OS Assembler Reference 
manual to determine the maximum number of 
operands. 


INVALID INDIRECTION OR LITERAL USAGE. 


LINE 


NUMBER 


nnann 


nnann 


nnnn 


nnnn 


nnann 


nnnn 


nnann 


nnnn 


nanan 


nnann 


nnnn 


Annan 


ERROR 


TYPE 


W 


ERROR 


CODE 


AS04033 


AS04034 


AS04035 


AS04036 


AS04037 


AS04038 


AS04039 


AS04040 


AS04041 


AS04042 
AS04043 


AS04044 


MESSAGE TEXT 


LITERAL POOL SIZE EXCEEDS MEMORY 
LIMITS. 

The current literal pool is located at an address 
greater than 65,535. Binary generation is 
suppressed. 


INVALID USE OF STRING CONSTANT. 
A string constant may have been used as an 
address or as a register designator. 


LOSS OF SIGNIFICANCE. 
An immediate operand cannot contain the 
amount coded. 


INVALID RELOCATION. 
More than one relocatable value remains after 
evaluation. 


REQUIRED SUBOPERAND MISSING. 
An instruction which must have a certain 
minimum of operands or suboperands has 
been coded without one or more of them. 


VALUE NOT WITHIN RANGE OF 
DESIGNATED FIELD. 

The resolved value exceeds the maximum 
value permitted. 


EXPLICIT USE OF REGISTER ZERO AS 
AN INDEX. 

Register zero has no effect as an index register, 
but it was coded as an index. 


TRUNCATION OCCURRED. 

A string constant used in a direct instruction 
exceeds 2 bytes. Normal rules of truncation 
are used. 


WORD BOUNDING REQUIRED. 
The instruction functions only on even bounded 
addresses, but an odd address was coded. 


RELOCATABLE TERM USED — ABSOLUTE 
VAL VE REQUIRED. 


EDIT LENGTH L2 MUST BE GREATER THAN 
L1 UNLESS L2 IS ZERO. 


INVALID USE OF $SYSEG. 
$SYSEG is not allowed as an operand or sub- 
operand of any machine instruction. 


LINE 


NUMBER 


nnnan 


nnonan 


ERROR 


TYPE 


F 


ERROR 


CODE 


AS04045 


AS04046 
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MESSAGE TEXT 


INVALID ENTRY POINT. 

The entry point did not resolve to a relocatable 
value. Note that the line number is associated 
with the END statement because the fact cannot 
be discovered when the ENTRY instruction was 
encountered. 


MORE THAN 175 SEG DIRECTIVES 
ENCOUNTERED — FIRST 175 USED. 


ASSEMBLER ABORT MESSAGES. 


The MRX/OS Assembler abort messages are printed as the final line(s) of the listing. The 
assembly is aborted when any of these messages appear. The messages and their explanations 
"are given below. The format of the messages is exactly as presented. 


MESSAGES 


ERROR !N PHASE CALL. 
Assembler in error. 


ERROR IN 1/O HANDLING. 


INPUT BLOCK SIZE EXCEEDS MEMORY AVAILABLE. 
The partition size is too small to handle the larger input block size. Increase the partition 
size for this input file. In 8K, the maximum input block size allowed is 86 bytes. 


PARTITION-SIZE LESS THAN 8K BYTES. 
The Assembler requires a minimum of 8K bytes to run. 


SYMBOL TABLE ERROR. 
Assembler in error. 


SYSTEM MACRO BLOCK SIZE TOO LARGE (GREATER THAN 86 BYTES). 


END OF INPUT OCCURRED WHILE PROCESSING A MACRO — MEND STATEMENT 
MISSING. 

Either an end of input or an END statement was detected while a macro definition was 
being processed. 


FATAL ERROR IN ICTL STATEMENT PARAMETER. 
In an ICTL statement, the first parameter is less than 1 or greater than 40, or the second 
parameter is less than 40 or greater than 120. 


PARAMETER 


| ao P 
DELIMITER ERROR IN COLUMN xx IN STATEMENT *.. .insert... 


PARAMETER CARD ERROR — JOB ABORTED. 

On a //PAR statement, either a parameter or a delimiter is in error. The contents of the 
//PAR statement, but not the characters //PAR, are printed as an insert between the 
asterisks. The column number, xx, indicates the erroneous character, column 1 being the 
first character between the asterisks. Several parameter or delimiter errors may be listed in 
succession before the PARAMETER CARD ERROR message. 


FATAL ERROR IN ICTL STATEMENT SYNTAX. 
The ICTL statement parameters must be separated by a comma and terminated by a space. 


G-25 


SPECIFIED IMEM NOT FOUND IN LIBRARY. 
Either the member name does not exist or the wrong library name was used. 


MEND STATEMENT MISSING IN SYSTEM MACRO. 

While processing a system macro definition an end of input was detected, but not a MEND 
statement. Check if the system macro library has been destroyed or if just one macro was 
incorrectly written on it. 


BINARY REQUESTED — BUT OMEM1 NOT SUPPLIED. 
A member name must be provided so that the binary may be entered in the object library 


under that name. 


OPERAND MISSING IN ICTL STATEMENT. 
An ICTL statement requires an operand entry. 


SYSTEM MESSAGES 


The following system messages cause the assembler to abort. 


ERROR CODE 


5021 


21nn 


24nn 


MESSAGE TEXT 


ILLEGAL BLOCK NUMBER. 

If the assembly process has not reached the print phase, the most 
probable cause is too small an allocation of MAXSIZ. Another 
possible cause is too small a file allocated for OMEM2. 


If the assembly process has reached the print stage, the most 
probable cause is that the binary file (OQUTPUT1) has been filled. 


These errors are probably caused by an error in the Control Language 
statements. 


These errors are probably caused by an error in the Control Language 
statements. Error 2109 indicates too large a MAXSIZ as a probable 
cause. Error 240B indicates that one or more of the user-supplied 
files is noncontiguous. The file with multiple extents must be 
recreated as a contiguous file. 
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INDEX 


Abort messages 
Absolute 


expressions, definition of 
terms, definition of 
Addressing in machine instructions 


ADO statement 

AGO statement 

ALIGN statement 

Alignment 
of data 


of machine instructions 
Alphabetical list of machine 


instructions 
ANOP statement 
Arithmetic 
constants 
operators 
set expressions 


Assembler instructions 


definition 

overview | 

summary 
Assembly options 


BDD statement 

Begin-end columns 
alteration of 
description 

BRS statement 

Byte reserve storage 

Byte defined data 


Calling assembler 
Card codes 
Character 

codes 

set . 

set expression 

string constants 
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2-17 
2-4 
3-2,3-3 
10-20 
10-23 
6-6 


8-2 
3-1 


C-1 
10-23 


2-7 
2-16 
10-16 


1-1 
4-1 
E-1 
11-1 


8-2 


Coding form 
format of 
statement continuation 
COM statement 
Comments 
Common control sections (see 


COM statement) 
Conditional assembly statements 


ADO 

AGO 

ANOP 

GBLA 

GBLC 

SETA 

SETC 
Constants 

arithmetic 

string 
Continuation of statements 
Control language for assembler 
Control sections 

and location counter 

assembler statements for 


Count attribute of macro instruc- 


tion operand 
Cross reference list, suppressing 
CSECT statement 


Data definition statements 
Diagnostic messages 


EBCDIC table 
EJECT statement 
END statement 
ENTRY statement 
EQU statement 
Error messages 
abort messages 
diagnostic messages 
system messages 


Index-1 
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Expressions 
absolute 
definition 
evaluation of 
relocatable 
Extended mnemonics 
EXTRN statement 


Floating point string constants 
FORM definition statement 
FORM definition statement 
FORM instruction statement 


GBLA statement 
GBLC statement 
General purpose machine instruc- 
tions 
Global arithmetic and character 
set symbols 


Hex codes of machine instruc- 
tions 
Hexadecimal string constants 


ICTL statement 
Identification-sequence field 
Index registers 

Input format control 

Integer string constants 
ISEQ statement 


Job control language (see 
Control language) 


Linkage editor 
and control sections 
and symbol linkage 
map directive (SEG) 
Linking statements 
Listing control statements 
EJECT 
PRINT 
SPACE 
TITLE 
Literal pools 
and LTORG statement 
description 
Literals 
description 
in WDD and BDD statements 


Location counter 
and ALIGN statement 
and ORG statement 
and WDD and BDD statements 
description . 
reference (asterisk) 

Logical operators 

LTORG statement 


Machine instructions 
alphabetical list 
definition 
hex code to mnemonic 
object formats 
summary 
Macro language 
concatenation of variable 
symbols 
count attribute 
example 
file definition 
general description 
macro definition. 
macro instruction 
MEXIT statement 
MNOTE statement 
nesting of macros 
number attribute 
sublists in macro instructions 
sublists in model statements 
substring notation 
system variable symbols 
(&SYSNDX, &SYSECT) 
Messages, error 
Mnemonic definition (FORM) 


Name field, description 

Notation used to describe 
machine instructions 

Number attribute of macro 
instruction operand 


Object formats of machine instruc- 


tions 
Object program 
definition 
file definition 


Index-2 


11-1 


Operand field, description 

Operating system, relationship to 
assembler 

Operation codes (hex) for 
machine instructions 

Operation field, description 

Operators 

Ordinary symbols 

ORG statement 


Packed decimal string constants 
PRINT statement 
Program 
control statements 
listing 
sectioning 
termination 
PUNCH statement 


Registers 
Relational operators 
Relocatable 
expressions, definition of 
symbols, identification of 
terms, definition of 
Reserving storage 


SEG statement 
Segment names (see SYSEG) 
Sequence checking statements 
Sequence symbols 
Set symbols 
SETA statement 
SETC statement 
Source program 
definition 
file definition 
listing control 
Source statements 
basic format 
character set 
coding form 
expressions 


6-5 
211 
10-16 
10-16 
10-18 


1-1 
11-1 
9-1,11-2 


2-3 

2-1 

2-18 
2-3,2-14 
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Source statements (continued) 
terms 
SPACE statement 
String constants 
character 
floating point 
hexadecimal 
integer 
packed decimal 
zoned decimal 
Symbol definition statements 
Symbol length attribute 
Symbolic linkage statements 


Symbols 


definition 

ordinary 

rules for using 

sequence 

variable 
SYSEG reserved name 
System 

machine instructions 

messages 

requirements for assembler 
TITLE statement 
Termination of assembly 
Terms 

constants 

definition 

literals 

location counter reference 

symbols 

symbol length attribute 


Variable symbols 


WDD statement 
Word defined data 
Word reserve storage 
Writing to disk file 
WRS statement 


Zoned decimal string constants 
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LITERALS 


A literal term is used to introduce data into a program. The formats of a literal term are as 
follows. 


=a a = Data value to be generated (required); any legal expression 
except another literal term. 

=a(b,c) b = Length specification (in bytes): a positive absolute expres- 
sion. If omitted, the length specification is the implied size 

=a(b) of the expression. 

_ c = Repetition factor; a positive absolute expression. If omitted, 

=a(,c) a repetition of 1 is assumed. If the size or length is specified 


symbolically, the symbol must have been previously defined. 
Where: . 


Examples of literals are shown in Figure 2-9. 


==C’ABD’' Invalid: literal cannot define another literal. 
=C’ABD'(4,3) Valid: same as =C‘ABD ABD ABD’ 
=A+B/2+4 Valid: implied length is the length of symbol A; implied 


repetition factor is 1. 
=P’-446'(6) Valid: specified length is 6; implied repetition factor is 1. 


=X‘FFO0'(,3) Valid: implied length is 2; specified repetition factor is 3. 


Figure 2-9. Examples of Literals 


The assembler generates the literal data, stores this data in a literal pool, and places the 
address of the stored data in the operand field of the statement using the literal. The 
position of the literal pool may be controlled by the programmer with the LTORG 
assembler statement. If LTORG is not specified at the end of a control section, the literal 
pool for that segment is placed at the end of the first control section. 


A literal can be defined at any point in a program by specifying the literal in the operand of 
the statement in which it is used. In contrast, data definition statements define and label 
data, and then the label is used to specify the data. 


A literal may not be combined with any other term, nor may a literal be used as a receiving 
field of a statement that modifies storage. 


Literals are relocatable, because the address of the literal, not the literal itself, is assembled 
into the statement using the literal. 
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A,BHCD,52,;HERE HERE is acomment. The four operands are: 
CON [A ] [BHCD ] [52] and [CON]. 


Blank 


A blank signifies the end of the operand field. Characters following a blank are considered 
comments. 


SUBLISTS IN MACRO INSTRUCTIONS 


To group a number of suboperands as a single symbolic parameter value, the macro 
instruction operand is written as a sublist. A sublist consists of one or more suboperands 
separated by commas and enclosed in parentheses. Each suboperand has form identical to an 
operand. The entire sublist including the parentheses is considered one macro instruction 
operand. 


Omitted suboperands have a null value. However, the operand () is considered a character 
string, not a sublist with all the suboperands omitted. The operand limit of 127 characters 
applies to the entire sublist. Examples of valid sublists are: 


(A,2,4,16) Four suboperands 


(A+40,B(2,6),(N,M),240/C+X) Four suboperands 


SUBLISTS IN MODEL STATEMENTS 


In a macro instruction operand, a sublist can assign a set of values to a single symbolic 
parameter of the macro definition. Any model statement may reference the entire symbolic 
parameter, but only a SETA, SETC, or ADO statement can reference the suboperands of the 
symbolic parameter. 


The format used to reference a suboperand is: symbolic parameter (n). 
The subscript n is an arithmetic set expression that refers to the position of the suboperand 
being referenced. For example, &LIST(2) references the second suboperand of the symbolic 


parameter, &LIST. 


If the sublist (A,,C20,’192’,(N,M)) is a macro instruction operand corresponding to the 
symbolic parameter &FIEL D, the values assigned to the suboperands are: 


FIEL D(O) = null 
FIELD(1)=A 
FIELD(2) = null 


FIELD(3) = C20 
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FIEL D(4) = '192’ 

FIELD(5) = (N,M) 

FIELD(6) through FIELD(n) = null 
A subscripted reference to an omitted sublist element, such as FIELD(2) above, is assigned a 
null value. If the macro instruction operand is a simple operand, rather than a sublist, the 
macro instruction can refer to the operand value by the symbolic parameter without a 
subscript, or by the symbolic parameter with a subscript of 1. All other subscripted 
references have a null value. 
Suboperands of sublists within a sublist (for example, N in FIELD(5) above) cannot be 
referenced in a model statement. 
SUBSTRING NOTATION 
Substring notation allows the programmer to reference part of a macro instruction operand 
or a character string constant. Substring notation consists of a symbolic parameter or a 
character string constant, immediately followed by two arithmetic set expressions separated 
by a comma and enclosed in parentheses, as in the examples: 

&NAME(2,4) 

C'AB24CFG'"(&P 1,2) 
The first expression indicates the position of the first character to be included in the 
substring. The second expression indicates the number of consecutive characters (beginning 
with the character indicated by the first expression) to be included in the substring. 
lf the substring specifies more characters than are in the macro instruction operand or in the 
character string constant, only the number of available characters are supplied. If the 
starting character is outside the range of the string, a null character is supplied. 


Substring notation has the following limitations: 


1. Substrings can only be specified for character string constants and 
macro instruction operands. 


2. A substring of a sublist cannot be specified. 


3. A substring reference can only be used as a term in a conditional 
assembly statement. 


Consider the example in Figure 10-4. 
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The operand field may contain an arithmetic set expression or one of the following 
character terms: 


Term Example 


Symbolic parameter, including sublist &PARM2(3) 
and substring references 


SETC symbol, including substring &SET1 
references 

Substring of a character constant C‘ABCDE'(2,3) 
&SYSECT reference &SYSECT 
Character constant C‘ABCD’ 
&SYSNDX reference &SYSNDX 


Only one operand is allowed. The maximum size of an assigned character value is 16 bytes. 
If a larger value appears, only the leftmost 16 bytes are assigned by the assembler. 


When &SYSNDX is used as a single character term, the value is a string of four characters, 
including leading zeros. If the operand specified is an arithmetic set expression, the 
arithmetic value is converted to a 16-bit constant. 


Examples of va/id SETC operands are: 


C’24BK’ 

&P 1 

&P1(2,4) 

&P1&P2(2,1) 

&SETC 

&SYSECT 

&SYSNDX 

(&SYSNDX+10-&P 1 (2,4)/2)* &P2(2) <EQ >C’FID’ 


Examples of invalid SETC operands are: 


X'124' String constant other than a character constant 
C’AB2’+4 Character constant used as arithmetic operand 
ALPHA Ordinary symbol 

L’ALPHA Length attribute 
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GBLA AND GBLC — GLOBAL ARITHMETIC AND CHARACTER SET SYMBOLS 


Local set symbols are made global (available outside the macro) by a GBLA or GBLC 
statement. The format of the GBLA or GBLC statement is: 


Name Operation Operand 


GBLA and 
GBLC 


Blank 1-35 set symbols, 


separated by commas 


Global statements must appear immediately after a prototype statement or after another 
global statement. Any number of continuation lines may be used. 


When a set symbol is declared global, its assigned value is available to statements in the main 
program, but not to other macro definitions. To be available to other macro definitions, the 
set symbols must also be declared global in those macro definitions. 


If set symbols have not been assigned values outside this macro definition or by a previous 
call to this definition, the global statement assigns an initial value of 0 to SETA symbols and 
a null character value to SETC symbols. If the set symbols have an assigned value, the global 
statements do not affect the value of the set symbols. 


ADO — ITERATIVE RETURN 


The ADO statement sets up a loop between the ADO statement and a subsequent statement 
identified in the ADO statement. The format of the ADO statement is: 


Name Operation 


Operand 


Sequence ADO Positive arithmetic set 
symbol, set expression, sequence symbol 
symbol, or 

blank 


The sequence symbol in the name field can only be referenced by an AGO statement. 


The operand field must have two operands, separated by a comma. The first operand is a 
positive arithmetic set expression that indicates the number of iterations to be executed. 
The second operand is a sequence symbol that specifies the last statement of the loop. This 
sequence symbol must appear in the name field of a statement that follows, not precedes, 
the ADO statement. The sequence symbol cannot be in the name field of another ADO 
statement, a macro instruction, or an AGO statement. 


If the set expression is equal to zero, control is transferred to the statement named in the 
second operand, and no intervening code is included. However, if the first operand is a 
positive number, the assembler subtracts 1 from the first operand and includes in the 
assembly all the code from the ADO statement to the statement named in the second 
operand. If the first operand is zero after the subtraction, the assembler does not return to 
the ADO statement but processes the next statement. If the first operand is not zero after 
the subtraction, the assembler again subtracts 1 from the first operand and repeats the loop. 
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Notice that when the first operand initially is zero, the jump is made to the statement 
named in the second operand. When the first operand is not initially zero, the indicated 
number of loops is performed and a jump is made to the first statement after the statement 
named in the second operand. If the first operand is invalid, the value is set to 1. 


The name field may contain a sequence symbol, a set symbol, or a blank. If the name field 
contains a set symbol, the symbol is initially assigned a value of 1. For each iteration, this 
value increases by one while the first operand of ADO decreases by one. Thus, in the 
following example, after 10 iterations, the first operand is O and &COUNT is 10. 


10 11 12 13 14 15 16 17] 18} 19 20 21 22 23 24 26 26 27.28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 
a i alam An hb i 


E LZ ,...END. FEE Cee CRED MER Teisee oeaaeT Ramet) CS COE WORMED KOMME ite Poe eee Reade Ree $a PE Sa Bis ah dh, 
a ape eee Oe ee, 


eC ce ee oo a See o a ee a os Cn ae nes Cn jeanne Smile 6 i. 4 a a Mranices 


OPERATION 


NAME OPERAND 


qe 34 Sob 78 


Bi eM Se die he a alee le ey acces els, ep ead SPs 4 4 4 fig A ge Sg ha 


The preceding statement performs a function equivalent to the following three statements. 
During the first iteration, &COUNT equals 1 and the first operand (10) is decreased by one. 
After 10 iterations, &COUNT equals 10 and the first operand equals 0. Control is then 
transferred to the first statement following the .END statement. 


OPERATION OPERAND 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 
ae air ny a a ey SS EN ru WO sr a SR 


we MM n 1 CE aes eres Ceeeeres CaaS ERY Seearees eee Cate Leer DS i. cst ek ee a) a a ge A 
is Ph END, re a Re Bas ce a Be tS, 8d P nea ee he oS ee 
Cc 1 t a L oe a on er oan Seen enn | 4 es Se aeeer | a a es os ices on Se See 9 


ha aie oh eaten Seedbre hg tk El ee NE a ek cepa! EXeoee! Sete | (ee eee 


Ge hee beled eahits ae ple dees (de ed I es, ee i oe oe Sal 


The ADO statement can be used to include or exclude code from the assembly, depending 
upon the value of the first operand, as in the following example. If the variable symbol 
&LABEL is equal to YES, the first operand of the ADO statement is 1, and all intervening 
code is included in the assembly. If, however, &LABEL is not equa! to YES, the first 
operand is zero and all intervening code is excluded. 


NAM i OPERATION 
2.3.4 5 6 7 819] 10 11 1213 14 15 16 


ie “ol 


OPERAND 


17} 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


: EL<EQ>C' YES',. Al. wos 4 1 ae. OR layal ree ae Cena 


agers Att zs ae Slack. Bl as 4 4 ieee 


ee nn oe ee Se a oe ee a ee on ee ae ee ee ee a 


:s a oa an, i con Cee A aa on ele me ba eh ht 


enon Onan Eneeey Caaf L n Je het hg 44 i 
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NESTING OF ADO STATEMENTS 


As many as six ADO statements can occur within a primary ADO loop. Such nesting of 
ADO statements increases the total number of iterations in geometric progression. If five 
iterations are performed by an outer ADO loop, an inner ADO with five iterations increases 
the number of iterations to 25. An inner ADO statement cannot reference a statement 
outside one referenced by the outer ADO. 


The following statements produce a 5 x 5 matrix containing all products of the ordinary 
numbers 1 through 5. 


i - END. Bo hk ‘ Se Sey Ce a cn on Sane CON GEE Scary Sees Gnenen Pe a yore os 
y 1 @ (ORS Wypect’ Ce ery Regeey yet! Senay aes Cee SE; CO Ce ee ay EO SP (OA eA aE ey ee Ones CUERET Whp tee Ok is Corina Pree (9 
*4ROW 
“ CoOL &. Fes eee am Yet! On! Cerape CORSeNY EQN CREE OEP Igo ev eee CRS ee Ee Comme Eeeeee’ Woes pe EER eRe ER 
aoe 2 rat 


es Sone Seene Ae Ree Meee ends. oft 7 ne ey Ses Cee Ee Oe oe ns en, Se ee en a Se ann cn Sr Seen 


dose a) ied or eee he he ed a 4 Jd 


During the first iteration of the outer ADO (named &COL), &COL equals 1 and &ROW 
increases by 1 with each iteration of the &ROW ADO statement until &ROW equals 5. 
During this first iteration, the statement .END WDD &COL *&ROW produces the values 1, 
2, 3, 4, and 5, as shown in the first column of values in this matrix. 

First Pass of the Outer ADO 


&COL 
1 2 3 4 § 


&ROW 


oR ON — 
oP ON = 


During the second iteration of the outer ADO, &COL equals 2 and &ROW again equals 1 
through 5. The second column of values is produced. 
Second Pass of the Outer ADO 


&COL 
3 4 #5 


_ 
NO 


&ROW 


oOhWN = 
OoRhWN 
—- OO BN 
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Il. CONTROL LANGUAGE STATEMENTS 


The Control Language for the assembler must provide the following four basic services: 


i Call the assembler into execution 

2. Specify the assembly options 

3. Define source input, object output, source output, and macro library 
input files 

4. Obtain the source program from the card reader, library member, or 


spooled input 


The Control Language statements for the assembler are explained below. For the exact 
format of the statements, consult the MRX/OS Control Language Services, Extended 
Reference manual. 


Control 
Language 
Statement Parameter Description 
//EXEC PGM= ASM | Calls the assembler into execution. 
//PAR Keyword options Specifies the assembly options in 
free form. 
//PAR IMEM= Input-member-name Specifies the name of the input source 


module on the library. If omitted, the 
source is assumed to be a non- 
partitioned sequential data file (such 
as a spooled input file). 


Control 


Language 

Statement Parameter Description 

//PAR OMEM1= Output-member-name Specifies the name of the relocatable 
object module on the library. If 
omitted and OBJECT=YES or COND, 
the assembly is aborted. 

//PAR OMEM2= Punch-indicator 1-10 alphabetic characters to indicate 
that PUNCH output is expected. If 
omitted, no PUNCH output is produced. 

//PAR MAXSIZ= 1-5 decimal digits Specifies the approximate number of 
source lines generated in the program. 
If omitted, the default value is the 
SYSGEN parameter, usually 1000. 

//PAR LIST= YES Specifies whether the source program is 

NO to be listed: 
YES List source program 
NO Omit listing 
If omitted, the default parameter is 
YES. 
//PAR XREF= YES Specifies whether a cross-reference list 
NO is to be generated: 
YES Generate cross-reference list 
NO Omit cross reference list 
//PAR ERROR= | YES Specifies whether warning errors are to 
NO be listed: 
YES List warning errors 
NO Omit listing 
if omitted, the default parameter is YES. 
Fatal errors are always listed. 
//PAR OBJECT= YES | Specifies under what conditions a relocatable 
NO object module is to be generated: 
COND) 


YES Module is generated unconditionally 

NO Module is not generated 

COND Module is generated if no fatal: 
error occurred 


If omitted, the default parameter is YES. 
If the option, YES or COND, is selected, 
the OMEM1 option must be specified. 
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Control 
Language 


Statement 


//DEF ID= 


//DEF ID= 


//DEF ID= 


//DEF ID= 


//DEF ID= 


//DEF ID= 


lf MACLIB is not specified, the default file name is $SYSMACLIB. The INPUT and LIST 
files must always be defined; the OUTPUT1 and OUTPUT2 files are optional. DEFINE 
statements may also include keyword parameters to identify the file name or the device 


Parameter 


File identifier 


INPUT 


OUTPUT 1 


OUTPUT2 


LIST 


MACLIB 


with which the file is associated. 


If the source program is to be read from the card reader, the source program card deck must 


Description 


Defines the source input, object output, 
source output, list output, and macro 
library input files. 


Source input file 


Relocatable output file: must be 252 
bytes, blocked 1. The file must be a 
partitioned data file. The device must 
be disc. CSD=YES 


Source punch file identifier: must be 
80 bytes, blocked 1. The file must be 
a non-partitioned sequential data set. 
CSD=YES 


List output file: must be 132 bytes, 
blocked 1. The file must be a sequential 
data set. CSD=NO. The file is written 
with the first character being a “native” 
mode control character for a printer. 


Macro library input: the file must be a 
partitioned data set, CSD format, 80 
byte records, blocked 1. 


be preceded by a //DATA FIL=SYSCRD staternent and terminated by a /* card. 


The cards in Figure 11-1 illustrate the Control Language statements to specify: 


e Source input from cards 

e Relocatable output to a specified library member 
e List output to printer 

e Cross-reference output 


Source 
Program 


HIDATA FIL=SYSCRD 
//DEF 1D=OUTPUT1,FIL=$LIB 
//DEF 1D=LIST,DEV=PRINTER 


//DEF ID=INPUT,DEV=SYSCRD 


//EXEC PGM=ASM 


Figure 11-1. Example of Cc 


//PAR OMEM1=PRG2,XREF=YES 


\ Language Statements 


2. WRITING SOURCE STATEMENTS 


To write source statements, the programmer should be familiar with the following topics: 


e Character set 

e Basic format of source nent 
e Types of terms and expressions 

® Coding form 


CHARACTER SET 


Source statements may contain the following characters: 


Letters 


Digits 0 through 9 


A through Z, and $ 


Special 
Characters 


The EBCDIC formats and card punch codes for these characters are listed in Appendix A. 
Any of the 256 punch combinations may appear inside a character constant, in comments, 
or in macro instruction operands. The meanings of these characters, and combinations of 
these characters, are explained in Figure 2-1. 
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Character Explanation 


A through Z, and $ Used in symbols and character string constants 
0 through 9 Used in numeric constants and symbols 


‘ Operand or suboperand separator 


= Indicates a literal term or a keyword parameter 
value 

C’ Defines.a character constant (all characters to 
the next apostrophe) 


x’ Defines a hexadecimal string constant (al! hexa- 
decimal characters to the next apostrophe) 


P’ Defines a packed decimal string constant (all 
characters to the next apostrophe) 

zZ' Defines a zoned decimal string constant (all 
characters to the next apostrophe) 


' Defines an integer string constant (all 
characters to the next apostrophe) 


Defines a hexadecimal arithmetic constant 


Define relational (EQ, GT, LT, NE, LE, GE) 


aed and logical (NOT, AND, OR, EOR) operations 

LE? Defines a reference to a symbol length 
attribute 

if Location counter reference or multiplication 
indicator 

/ Division indicator (Note that 1/2=0 because 
division always results in an integer, not a 
fraction.) 

+ Addition Indicator 


- Subtraction Indicator 


& Defines a variable symbol 


() Separates an address-modifying index from the 
rest of the address, delimits sublisted operands, 
or encloses operands or suboperands 


Used for sequence symbols and concatenation 


Used for macro definition comments 


# The character following this symbol is to be 
evaluated for its titeral value, not for its special 
function. In the example, the symbol following 
the # sign is a semicolon, not a continuation 
indicator. 


: Continuation indicator 


@ Indirect Addressing 


blank field separator 


Figure 2-1. Character Usage 
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Example 
C'ACCOUNT NO.' 
TAG3,5825 
HERE, THERE 


=A+2 


C'ABC’ 


X'1AFEE’ 


P’425' 


z'-44' 


1'4286' 


“FFIA 


A<EQ>B 
A<AND>B 


L’SYMX 
¥44 
12*20 
10/0 
TAG/B 
TAG+12 
TAB-4 
&TAC 


PAG(R2) 


-LAST 
.*COMMENT 


C'24# :4' 


THE STATEMENT 1S; 
@REG1,@TAG1 


ADDR 3,4 


BASIC FORMAT OF SOURCE STATEMENTS 


Source program statements have the fields outlined in Figure 2-2. 


Operation Operand Comment 


Any symbol | Machine instruction, Single expression, Informational material 


or blank assembler instruction, | several expressions, | or blank 
macro instruction, or or blank 
FORM instruction 


Figure 2-2. Source Statement Format 


The name field entry is a symbol used to identify a statement. The name field is necessary 
for certain statements, or when the statement is referred to in another statement, such as in 
a Branch instruction. 


The operation field entry is a predefined mnemonic code (or mnemonic) which identifies 
the function of a machine, macro, assembler, or FORM instruction. Mnemonics are designed 
to be easily learned and remembered; for example, ADDR for Add Register-Register, or 
EQU for an Equate assembler instruction. 


The operand field entry defines or identifies the data involved in the operation. Most 
statements have one or more operands, although some statements have no operands at all. 
Each operand has one or more terms, which may be used in a combination to form one or 
more expressions. (Refer to immediately following text for a discussion of terms and 
expressions.) An operand field may not have more than 35 terms. Operands of machine 
statements generally represent storage locations, general registers, immediate data, or 
constant values. Operands of assembler statements provide the information necessary for the 
assembler to perform the designated operation. 


The optional comment field contains any informational material the programmer wishes to 
add. 

TERMS AND EXPRESSIONS 

A term is a symbol, character, or number that represents a value; an expression is a single 


term or a combination of terms. An expression is used in the operand field of a source 
statement. The following text fully defines terms and expressions. 
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TERMS 


Every term represents a value; the value may be assigned by the assembler program (symbol, 
symbol length attribute, location counter reference) or may be inherent in the term itself 
(constant, literal). 


An arithmetic combination of terms is reduced to a single arithmetic value by the assembler. 
An arithmetic value is represented as a 16-bit binary value in two’s complement form. A 
logical value has a range of 0 through 65,535; and an arithmetic value has a range of -32,768 
through 32,767. Limitations on the value of an expression depend on its use. For example, a 
term designating a general register must have a value between O-7 inclusively; a term 
representing an address must not exceed the size of storage. 


A term is absolute if its value does not change upon program relocation. It is relocatable if 
its value changes upon program relocation. . 


The terms used in assembler statements are outlined in Figure 2-3. An explanation of each 
type of term and the rules for its use are provided in the following text. 


Character String 
Constant C’ABC' 


Hexadecimal String 
Constant X'C49FE' 


Packed Decimal 
String Constants String Constant P’-244' 


Zoned Decimal 
String Constant Z2'246' 


integer String 
Constants Constant 1'-323’ 


Decimal! Arithmetic 


Arithmetic Ponctnk 2316 
Constants 

Hexadecimal Arithmetic 

Constant "2FA 
Ordinary Symbols 

Symbolic Parameter &TAB1 

Symbols Variable Symbols System Variable Symbols &SYSNDX 
Set Symbols &TAB3 


Sequence Symbols 


Location 
Counter 
Reference *.20 


Symbol 
Length 
Attribute L'TAB1 


Literals =HERE 
Figure 2-3. Types of Terms 
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CONSTANTS 


Constants are terms whose values are inherent in the’ terms themselves. They specify 
machine values or bit configurations directly, rather than by equating the values to symbols 
and then using symbolic references. Constants represent such program elements as 
immediate data, masks, registers, addresses, and address increments. 


Constants are string or arithmetic. String constants are of variable size; arithmetic constants 
are 16 bits long. Examples of all types of constants are presented in Figure 2-6. 


String Constants 


A string constant can only be used as a single term expression, or in a relational expression. 
In a relational expression, both terms must be of the same type (character, hexadecimal, 
etc.), for example: C‘'ABCE’< LT >C’&P1’. 


Character String Constant 


A character string constant is written as the letter C followed by a character string enclosed 
in apostrophes, for example: C’‘STRING’. To represent the literal value of an apostrophe, an 
ampersand, a semicolon, or a pound sign as part of the character constant, the character 
must be immediately preceded by an escape character, which is the pound sign. The length 
of a character constant is equal to the number of characters in the constant, excluding the 
escape characters, which do not appear in storage. 


Examples of character constants are shown in Figure 2-4. In the last example of Figure 2-4, 
the generated code is: THIS CHARACTER STRING HAS MANY SPECIAL CHARACTERS 
INIT: #:'&. 


OPERAND . 


17 19 19. 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38.39 40.41 42 43.44 45 46 47 48 49 50 51 52 53.54 55 56.57 58 59 60 G1 62.63 64 65 66 67 68.69 7071, 
ameter nome 


"THIS. TS A MESSAGE’. | dd ee of alee: 


Be eee | Beste 8 hoe ae kk 4 4 re de DES as soe a koa 


PINTS, CHARACTER, STRING) on 
CONTINVED.'. ner en © nee CE Le eee arene e: 


TALS, CHARACTER STRING#;3IS NoT CONTINVED’........._... 
b’ THES STRING HAS, MANY. SPECIAL. CHARS. IN LT aie a eae! | 


‘ Bach ha eo SS boa 


Figure 2-4. Character Constants 
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If the following characters are not preceded by an escape character in a character constant, 
they have the meaning given below: 


Character Meaning 


A character constant is continued on the next line 
Boodet Encloses the characters of a character constant 
Variable symbol 


Next character retains its literal value 


Hexadecimal String Constant 


A hexadecimal! string constant is written as the letter X followed by a string of hexadecimal 
digits enclosed in apostrophes, such as: X’C49FE’. Each hexadecimal digit is translated into 
its four-bit equivalent. The maximum size of a hexadecimal string constant is limited to the 
maximum number of digits that can be contained on two coding lines. If an odd number of 
digits is specified, the leftmost four bits in the leftmost byte are set to zero. The implied 
length of the constant is half the number of hexadecimal digits in the constant, rounded to 
the next higher integer. 


Packed Decimal String Constant 


A packed decimal string constant is written as the letter P followed by a signed integer 
number enclosed in apostrophes, such as: P’-244’. If the sign is omitted, the number is 
assumed to be positive. Each pair of decimal digits is translated into one byte. The rightmost 
byte of a packed field contains the rightmost digit and the sign. Signs generated are ‘’C76”" 
for plus, and “D716” for minus. The maximum length of a packed decimal string constant is 
limited to the number of digits that can be contained on two coding lines. 


Zoned Decimal String Constant 


A zoned decimal string constant is written as the letter Z followed by a signed integer 
number enclosed in apostrophes, for example: Z2‘'246’. If the sign is omitted, the number is 
assumed to be positive. Each decimal digit is translated into one byte. The rightmost byte 
contains the sign and the rightmost digit. Signs generated are ‘‘C16” for plus, and ““‘D16” for 
minus. The maximum length of a zoned decimal string constant is limited to the number of 
digits that can be contained on two coding lines. 


Integer String Constant 


An integer string constant is written as the letter | followed by a signed integer number 
enclosed in apostrophes, such as: !’-246’. If the sign is omitted, the number is assumed to be 
positive. An integer string constant is translated into its four-byte binary equivalent. Integer 
constants consist of 1-10 digits with a value ranging from -231 to 231-1. The constant is 
word aligned when used in a WDD statement or a literal. 
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Explicit Length= 


Explicit Length> 


When string constants define data in storage, truncation and padding of their values is 
performed according to the rules presented in Figure 2-5. 


Explicit Length < 


Constant Implicit Length Implicit Length Implicit Length 
Character C’ABC'(3)=ABC Left justify. Left justify. 
Blank fill on right. Truncate on right. 
C'ABC’ Warning message is given. 


Hexadecimal 


X10A’ constant contains an Warning message is given. 
odd number of digits. X'10A’(3)=00010A 
X'10A'(1)=0A 
X'10A'(2)=010A 
Packed Right justify. Right justify. Right justify. 
Decimal Zero fill on left if the Zero fill on left. Truncate on left. 
constant contains even Warning message is given. 
P’-24' number of digits. P‘-24'(3)=00024D 
P’-24'(1)=4D 
P’-24'(2)=024D 
Zoned 2'123'(3)=F1F2C3 Right justify. Right justify. 
Decimal Zero fill on left. Truncate on left. 
Warning message is given. 
2'123' 2'123'(4)=FOF1F2C3 
F'123'(2)=F2C3 
Integer Right justify. Right justify. Right justify. 
Propagate sign on left. Propagate sign on left. Truncate on left. 
\'-758' Sign is lost. 
1'-758'(4)=FFFFFDOA 1'-758'(6)= Warning message is given. 
FFFFFFFFFD0A 


Right justify. 
Zero fill on left if the 


C'ABC’(4)=ABC 


Right justify. 
Zero fill on left. 


C‘'ABC'(2)=AB 
Right justify. 
Truncate on feft. 


\’-758'(1)=0A 


Figure 2-5. Truncation and Padding of String Constant Values 


Arithmetic Constants 
Arithmetic constants can be used in multi-term expressions. An arithmetic constant is 
assembled as its two-byte binary equivalent. The maximum size of an arithmetic constant is 


216.1. If arithmetic constants are used in statements where an explicit size is specified, 
truncation and padding follow the same rules as those for an integer string constant. 


Decimal Arithmetic Constant 


A decimal arithmetic constant is written as an unsigned integer number of 1-5 digits, for 
example: 20. 
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Hexadecimal Arithmetic Constant 


A hexadecimal arithmetic constant is written as quotation marks followed by a string of 1-4 


hexadecimal digits, for example: ‘“2FA. Each hexadecimal digit is assembled as its four-bit 
binary equivalent. 


Type Example Generated Hexadecimal Code 


Character String C’F12AY9*' C6F1F2C1E8F95C 
C’'$z#'# #5’ 5BE97D7BF5 


C'B’ 


C2 

Hexadecimal String X'C49FE’ OC49FE 
X'F2’ F2 
x’C’ oc 


Packed Decimal String P14’ 014C 
P’925860’ 0925860C 
P'-2’ 2D 
P’-2596’ 02596D 


Zoned Decimal String Z2'14’ FiC4 
Z'925860' FOF2F5F8F6CO 
Z'-2' D2 
2'-2596' F2F5F9D6 

Integer String 1°14’ 00 00 00 OE 
1'925860' 00 OE 20 A4 
I'-2’ FFFFFF FF 
1'-2596' FFFFFSDC 


Decimal Arithmetic 14 


Hexadecimal Arithmetic 


Figure 2-6. Examples of Assembled Constants 


SYMBOLS 


A symbol is a character or combination of characters used to represent locations or arbitrary 
values. Symbols, through their use in name fields and Operands, provide the programmer 


with an efficient way to name and reference a program element. A symbol is defined when 
it appears in the name field of a source statement. 
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If duplicate literals are specified within one literal pool, only one literal is stored. Literals 
are duplicate if their final specifications, size, and repetition factors are identical on a 
character-by-character basis. A literal may be a duplicate even when it appears to be 
different (see examples in Figure 2-10). A literal is a duplicate if it contains no forward 
references and the expressions evaluate to the same value as the corresponding expressions 
of an existing literal. 


A literal which contains a reference to the location counter is stored even if it duplicates 


another literal (see examples). If an expression used in a literal term contains a forward 
reference to a symbol, the symbol is assumed to represent a two-byte value. 


Examples of duplicate literals are shown in Figure 2-10. 


=C’ABC’'(4,3) Only one literal is stored. 

=C’ABC' (4,3) 

=C’ABC' Both literals are stored. 

=X'C1C2C3' 

=A+B Only one literal is stored if A and B are predefined symbols. 

=Bt+A 

=C<EQ>D Only one literal is stored if C is defined to be equal to D, so that the 
=1 expression is equal to 1. 

=*+10 Both literals are stored 

=*+10 


Figure 2-10. Examples of Duplicate Literals 


EXPRESSIONS 


An expression is defined as one or more terms linked by arithmetic, relational, or logical 
operators. Expressions may be single term or multi-term (see examples below). 


Single Term Expressions Multi-Term Expressions 

29 SYMX+40 

“FO A+B/2+10 

SYMX (X<OR >“FOFO)< EQ >(SP2<OR >“FOFO) 
: (((A+4)/2+1)*2< AND >"00FF) <EQ >24) 
L’SYMX *+L’BETA 

P’-240' A+B<LE>SUM 
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If the length specification or the repetition factor is zero, no data is generated, but the 
location counter is aligned on the specified word or byte boundary. 


Examples of WDD and BDD statements are shown in Figure 8-2. In the last example, if M = 
N, the term 35 is generated. If M = N, no data is generated, but the location counter is set 
on a word address, which is given the name NAM4. 


OPERAND 


a p) a - ao. 1 F . ‘ 1 1 


a 4 ’ ahah sap 4 te ‘ . . it ‘ . * " i 1 


Figure 8-2. Examples of WDD and BDD Statements 


The value attribute of the symbol in the name field is the address of the leftmost byte after 
alignment. The length attribute is the length in bytes (specified or implied) of the first (or 
only) data field in the operand. 


Omitted operands, signified by a comma without a data value, indicate a zero byte or word. 
The last data value in a string of multiple operands must be a specified data value, not an 
omitted operand. 


Consider the following example. Notice that an arithmetic constant, such as 45, uses two 
bytes. 


Statement Generated Data 

WDD _,12,, ,45 00 00 Word 1 
00.0C Word2 
00 00 Word3 
00 00 Word 4 
00 2D Word5 


If the data value is a relocatable expression other than $SYSEG, the length specification and 
the repetition factor have the following restrictions: 


1; The length attribute must be resolved to two bytes. If the length is 
not specified, two bytes are assumed. 


2. Alignment must be on a word boundary. 


For $SYSEG, the length attribute is 1 and alignment must be on an odd boundary. 
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Literals (which are always relocatable) in a WDD or BDD statement require special 
consideration. If a literal term is used in the WDD or BDD statement, the implied length and 
repetition attributes are (2,1). If other specifications are included, they refer to the literal 
term itself, but not to the symbol! defined in the name field. Consider this statement: 


NAME 
12345678 


The length attribute of the literal C’ABCD’(5,2) is 10; but the length attribute of the 
symbol B1 is 2, because the operand is a relocatable term. In all other cases, the symbol in 
the name field receives the length attribute of the first data field in the operand. 


OPERATION OPERAND 


10 11 1213 1¢ 15 16 17/181 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 3839 40 41 42 43.44 45 46 47 48 49 50 
preaneees warenner we See eee Cs ay ey Sy Oe eee Sere Ce ee ee NN eee 


WDD. 


If the location counter (*) is referenced in the operand field, the value attribute of the 
symbol in the name field replaces the operand. For example, TAG WDD *,*,* generates 
three words of data, each assigned the value attribute of TAG. If TAG is equal to to 1004, 
then 1004 1004 1004 is generated. 


For example, the following statement specifies that two 8-byte fields of all zeros are to be 
generated. TAG represents the address of the first byte of generated data. 


OPERAND 


If the location counter is pointing to OOFE, TAG is equal to OOFE and the storage locations 
are as follows. (The last byte is 010D or TAG+15.) 


Locations Contents 

OOFE 00 OO 

0100 00 OO . 

0102 00 00 First operand 
0104 00 OO 

0106 00 OO 

0108 00 OO 

010A 00 00 Second operand 
010C 00 00 


If the location counter is pointing to an odd-byte address when a WDD statement is 
encountered, the assembler automatically updates the counter to the next word boundary 
and does not affect the contents of the odd-byte address. 


In the preceding example, if the location counter is pointing to OOFD, the assembler updates 


the counter to OOFE and the contents of OOFD are unchanged. The storage locations are as 
follows. 
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2. Alphanumeric character constants are left-justified with blank fill on 
the right. If the actual data is larger than the defined field, the data is 
truncated on the right. 


3. Packed decimal values are right-justified with zero fill on the left. If 
the actual data is larger than the defined field, the data is truncated 
on the left. 

4, Zoned decimal values are right-justified with zero fill on the left. If 
the actual data is larger than the defined field, the data is truncated 
on the left. 

5. Integer string values and arithmetic values are right- justified with the 


sign propagated on the left. If the actual data is larger than the 
defined field, the data is truncated on the left and the sign is lost. 


The examples in Figure 84 illustrate certain padding and truncation rules. The first operand 
of TAB1, a hexadecimal 5 (0101), is truncated on the left and the two rightmost bits (01) 
are inserted in the 2-bit field defined by 2 in the FORM definition statement. If the value 
attribute of B in the second operand is less than C, the single bit position established in the 
corresponding definition statement is set to a binary 1. If B is greater than C, the bit is set to 
a binary O. 


The first A character constant (1100 0001 in EBCDIC) in the second TABLE statement is 
truncated on the right, and the remaining two leftmost bits (11) are assigned to location 
TAB2. Note, however, that all eight bits (1100 0001) of the second A character constant in 
the fourth operand position are retained at location TAB2+1. 


OPERAND 


1,5) 8,16 — 
BbeLTSC Nel, * “FH, ADDR, BYTE 7 


Figure 8-4. Examples of Padding and Truncation for Form Statements 


The following examples show a possible use of the FORM statement — redefining 
instructions to create a new language closer to English. In the first example, the “MOVE” 
instruction generates a MOVM machine instruction, using a FORM statement and a series of 
Equates. This corresponds to: MOVM BUFFERB(R2),@BUFFERA(R3). Assuming that 
BUFFERA is at address 63FA, the code generated is: 


602B 
63FA 


63FC 


OPERATION OPERAND 


=m,’ 4 ee cee es a aS rasan eee nee eT Cpe oe a core ae 
ad... Mh cast Sas Non Spe ele nae 

abi Sie ¢ se Mh ee ee Rk A itll a i Bg ee yg 
Ree de ia a a, a gg 

! n 1 1 1 a 1 ' ‘ ’ 1 aod re | a a | PS pe hog a ey eo eon a 

1 14 By. I 6, d ig 4 1 ADEE CRE? ES RENE DOTY Oper Y WONT aseeees emmen Meme pee ern? ern Memes em 

Be he cae ala adele et eA bth et tg dd eb a 


ce y 
MORY., DIRECT, Ra, INDIRECT, R3,. 
UFFERB, BUFFERA | 


is he a a 


Bie BREE SSNs Caches aa Bd a 


The next example shows a BRANCH FORM statement used alone to generate a BR machine 
instruction, or together with ROUTINE to generate a BSR machine instruction. Assuming 
that SUBROUT1 is at 2F3A, the code generated is: 

EAO7 

2F3A 


The last statement of this example, BRANCH REGISTER,R7, generates the code: EBO7. 


OPERATION OPERAND 


12.3.4 5 6 7. 8/9] 10 11 1213 14 15 16 1718] 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 3839 40 41 42 43.44 45 46 47 48 49 50 


(ilesecar eee! aera Ciamoer exrmer coeiras eee Eeeome rege eee epee Caen a SpOnnE GESMR Wenps Fen! cas CS 
= ro by Bt L Be yal n 
EQU fic day Vos VMS 458 rs re | wee Cees cone Bele Nera Gorey eet EO UNE | 

0 Ge a ae 4 ANNA ds WB a Co canes w ey lle i Nl 5 A 


i ; Cae eoeeee Canteen ace ed a < ae  ietou eneaeve aay eces) Maeeorooe Wore 
Ay ERT NOR 1 1 ‘ 1 ieee PE ee 5 a Sore ee a a ae ARS 
Rou , T ro tofos ioe 2 Sp 


D ‘ a ry 2 heer | 1 4. ry i L Di 2 A ee A A eS he 
REGIS T ER a R 7. ry 4 4 i ieee teee! econ ane t ry Basi casos he 2 
- 1 . a a 1 5 4 fee ere Se ene | 4 s a eo a on 7 4 1 ene eae eee 4 mall Fae Came weep! Ramey 


A detailed example of the FORM instruction can be found in Appendix F. 
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LINE 


NUMBER 


nnann 


annn 


nnnn 


nnnn 


nAnnn 


nnann 


nnnn 


nnann 


nnnn 


ERROR 
_VPE 


F 


ERROR 


_CODE_ 


AS02042 


AS02043 
AS02044 


AS02045 


AS02046 


AS02047 


AS02048 


AS02049 


AS02051 


MESSAGE TEXT 


OPERATION ENTRY MUST BE FOLLOWED 
BY A SPACE. 

The space is the delimiter of each field in the 
MRX Assembler. 


OPERATION CODE CANNOT BE CONTINUED. 


INVALID CHARACTER IN OPERATION 
ENTRY. 
Only valid characters are A-Z, 0-9, & and $. 


OPERATION ENTRY TOO LONG. 
Only 8 characters are allowed if there is no 
substitution in the operation entry. 


INVALID ISEQ PARAMETERS — COMMAND 

IGNORED. 

1. The parameter value is within the begin 
and end limits in the statement. 

2. The length of the sequence field is zero. 

3. The length of the sequence field is greater 
than 8 characters. 


MISPLACED ICTL STATEMENT. 
An ICTL statement must be the first statement 
of an assembly. 


STATEMENT VALID ONLY WITHINA 
MACRO. 
The following operation codes are allowed 
within a macro definition: 

GBLA 

GBLC 

MACRO 

MEND 

MNOTE 

MEXIT 


INVALID OR MISPLACED INSTRUCTION IN 
MACRO DEFINITION. 
The following operation codes are not allowed 
within a macro definition: 

PRINT 

ISEQ 

MACRO 
Also GBLA, GBLC must immediately follow the 
macro definition prototype. 


INVALID CONTINUATION. 
The continued statement has a continuation 
character as the first nonblank character. 


LINE 
NUMBER 
nann 


nnann 


nann 


nann 


nnann 


nnnn 


nann 


nnnan 


nnann 


nnaAnn 


nann 


malalatal 


nann 


nnann 


nnnn 


ERROR 
ues. 


W 


Ww 


ERROR 


CODE 


AS02052 


AS02053 


AS02054 


AS02055 


AS02056 


AS02057 


AS02058 


AS02059 


AS02060 


AS02061 


AS02062 


AS02063 


AS02064 


AS02065 


AS02066 


MESSAGE TEXT 


END STATEMENT SUPPLIED BY ASSEMBLER. 
End of input detected but no end card received. 


NAME FIELD OF MEND STATEMENT MAY 
ONLY CONTAIN A SEQUENCE SYMBOL. 


NAME FIELD OF MACRO DEFINITION 
HEADER MUST BE BLANK. 

The name of the operation code MACRO 
must be blank. 


REQUIRED OPERAND ENTRY MISSING. 
The operation code in the statement requires 
an operand field entry. 


SYMBOLIC PARAMETER CANNOT BE: 
USED AS A GBLA OR GBLC OPERAND. 


SET SYMBOL MAY NOT BE DEFINED AS 
BOTH SETA AND SETC. 


END QUOTE MISSING. 


MACHINE AND ASSEMBLER OPERATION 
CODES MAY NOT BE USED AS MACRO 
INSTRUCTION. 


MULTIPLE DEFINITION OF MACRO 
INSTRUCTION. 
Macro instruction has been previously defined. 


NAME ENTRY OF MACRO PROTOTYPE 
STATEMENT MUST BE BLANK ORA 
VARIABLE SYMBOL. 


MORE THAN 35 SYMBOLIC PARAMETERS. 
Only 35 symbolic parameters are allowed. 


NAME ENTRY OF MACRO INSTRUCTION 
MAY NOT BE A VARIABLE SYMBOL. 


STATEMENT OUT OF SEQUENCE. 


INVALID ISEO SYNTAX. 

In an ISEQ statement the name entry must be 
blank and the parameters must be separated by 
a comma and must be terminated by a space. 


INVALID ICTL SYNTAX. 
In an ICTL statement the name entry must be 
blank. 


LINE 
NUMBER 


nnann 


nnnn 


nnann 


NOTE: AS02115 reserved for future use. 


nnann 


NOTE: AS02117 reserved for future use. 


nnnn 


NOTE: ~ AS02119 reserved for future use. 


NOTE: AS02120 reserved for future use. 


Ww 


F 


F 


ERROR 
CODE 


AS02111 


AS02112 


AS02114 


AS02116 


AS02118 


MESSAGE TEXT 


REFERENCE TO DOUBLY-DEFINED 
SEQUENCE SYMBOL. 
The ADO or AGO statement is not processed. 


INSTRUCTION NOT VALID AFTER SEG 
STATEMENT. 
The instruction is not processed. 


SPECIFIED SUBSTRING — LENGTH TOO 
LARGE. 


INVALID USE OF SEQUENCE SYMBOL. 


INVALID USE OF CHARACTER STRING. 


NOTE: AS02121 and ASO2122 reserved for future use. 


nnann 


nnann 


nann 


nnann 


nnann 


nannn 


naAnn 


nann 


nann 


F 


AS02123 


AS02124 
AS02125 
AS02126 


AS02127 | 


AS03001 


AS03002 
AS03003 
AS03004 


EXPRESSION CONTAINS INCOMPATIBLE 
OPERAND TYPES. 


EVALUATOR — STACK OVERFLOW. 


MULTIPLICATION OR DIVISION OVERFLOW. 


UNDEFINED SEQUENCE SYMBOL OR 
VARIABLE SYMBOL. 


INVALID SUBSTRING OR SUBLIST 
REFERENCE. 


OPERAND SIZE OR NUMBER OF TERMS 
EXCEEDS MAXIMUM. 

This message indicates internal stack overflow. 
To correct the condition, reduce the number 
of terms in the expression or number of oper- 
ands. 


UNMATCHED RIGHT PARENTHESIS. 
UNMATCHED LEFT PARENTHESIS. 


EXPRESSION OR SUBLIST CONTAINS AN 
INVALID COMMA. 


LINE 


ERROR 


NUMBER TYPE 


NOTE: 


nnann 


nnann 


nann 


nnnn 


nnnan 


nnavAn 


nnann 


nnann 


NOTE: 


nnnn 


nnann 


AS03005 reserved for future use. 


F 


ERROR 
_CODE 


AS03006 


AS03007 


AS03008 


AS03009 


AS03010 


AS03011 


AS03012 


AS03013 


MESSAGE TEXT 


INVALID USE OF INDIRECTION 
*.. insert. . .* 
The use of the indirect operator, @, is invalid. 


INVALID EXPRESSION «.. .insert. . .* 


The syntax does not follow the rules for 
coding expressions. 


INVALID USE OF LITERALS «.. .insert. . .« 
The use of the literal operator, =, is invalid in 
this statement. 


INVAL ID USE OF PARENTHESIS 
*,, Insert. . .* 


CHARACTER STRING INVALID WITH 
+-* OR / OPERATOR «.. .insert. . .* 
Arithmetic operations are invalid with strings. 


INVALID SUBLIST «.. .insert. . .* 
The use of the sublist is invalid in this 
statement. 


RELOCATABLE TERM USED IN MULTI- 
PLICATION, DIVISION OR LOGICAL 
OPERATION «.. .insert. . .* 

The location counter, *, may not enter into 
the above mentioned operations. 


MAY NOT FOLLOW A LOGICAL, RELA- 
TIONAL OR ARITHMETIC OPERATOR 
*.. insert. . .* 

The unary operator NOT may not follow the 
above mentioned operators. 


AS03014 and ASO3015 are reserved for future use. 


F 


AS03016 


AS03017 


SYMBOL TOO LONG «.. .insert. . .* 
A name entry or a symbolic operand may not 
exceed 8 characters. 


INVALID HEXADECIMAL CONSTANT 
*,. insert. . .* 

A hexadecimal constant may only contain 
digits 0-9 and characters A-F. 


nnANn 
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MESSAGE TEXT 


OPERAND SIZE OR NUMBER OF TERMS 
EXCEEDS MAXIMUM «.. .insert. . .* 

This message indicates internal stack overflow. 
To correct the condition, reduce the number 
of terms in the expression or the number of 


INVALID OPERATOR «.. .insert. . .* 
The operator or symbol is not in the language. 


INVALID CHARACTER «.. .insert. . .* 
The character is not in the language or is 
contextually incorrect. 


INVALID CONTINUATION «.. .insert. . .* 
The usage of the semicolon is contextually 


INVALID SYMBOL «.. .insert. . .* 
The length attribute operand may only be 


INVALID STRING «.. .insert. . .* 
An invalid string structure appeared. 


INVALID STRING «. . .insert. . .* 
Same as AS03023 above. 


OPERAND TRUNCATED — TOO LONG 


The number of digits exceeds the maximum 
allowed. For a decimal integer, 5 is the 
maximum. For an integer string, 10 is the 
maximum. For a hexadecimal constant, 4 


VALUE TRUNCATED — EXCEEDS PER 
MISSIBLE MAGNITUDE «.. .insert. . 

A decimal integer may not exceed 65, 536. 

An integer string may not exceed 4,294,967,295. 


LINE ERROR ERROR 
NUMBER TYPE CODE 
nnnn F AS03018 
operands. 
nnnn F AS03019 
nnnn F AS03020 
nnnn F AS03021 
invalid. 
nnnn F AS03022 
symbolic. 
nnnn F AS03023 
NOTE: AS030024 is reserved for future use. 
nnnn F AS03025 
nnnn W AS03026 
*,..insert. . .* 
is the maximum. 
nnnn W AS03027 
NOTE: AS03028 and AS03029 are reserved for future use. 
WwW AS03030 


INVALID USE OF NAME ENTRY. 


LINE ERROR ERROR 
NUMBER _TYPE CODE 
nnnn F AS03031 
nnnn F AS03032 
nnnn F AS03033 
nnnn F AS03034 
nnnn F AS03035 
nnnn F AS03036 
nnnn F AS03037 
NOTE: AS03038 is reserved for future use. 
nnnn F AS03039 
nnnn F AS03040 
nnnn F AS03041 
NOTE: AS03042 is reserved for future use. 


MESSAGE TEXT 


INVALID FORM DEFINITION. 
A form reference cannot be used as an operand 
entry. 


INVALID USE OF $SYSEG. 
$SYSEG is invalid in an evaluated expression. 


RELOCATABLE TERM INVALID WITH 
UNARY OPERATOR. 

A relocatable term may not be used in con- 
junction with a NOT operator. 


INVALID USE OF STRING CONSTANT. 
A string constant may not be used as a term 
in conjunction with an arithmetic or logical 
operator. 


RELOCATABLE TERM INVALID WITH */ 
OR LOGICAL OPERATOR «.. .insert. . .* 
A relocatable term may not be used in con- 
junction with a multiplication, division, or 
logical operation. 


INVALID SYNTAX. 
The operand structure does not follow the 
rules of the language. 


MORE THAN SIX RELOCATABLE TERMS. 
An expression may not contain more than six 
unresolved relocatable terms. 


INVALID STRING «.. .insert. . .* 
Both strings in a relational or logical operation 
must be the same type. 


OPERAND SIZE OR NUMBER OF TERMS 
EXCEEDS MAXIMUM «.. .insert. . .* 
The expression size is too large to be evaluated. 


MULTIPLICATION OR DIVISION OVER- 
FLOW +*...insert...#* 

Either division overflow has occurred or the 
second term of a multiplication or division 
operation exceeds a 16-bit value. 


AS03045 is reserved for future use. 


ERROR 


CODE 


AS03043 


AS03044 


MESSAGE TEXT 


RELOCATABLE TERM INVALID WITH 
RELATIONAL OPERATOR ~.. .insert. . .* 
A relocatable term may not be used in con- 
junction with a relational operator. 


UNDEFINED SYMBOLIC OPERAND. 
The reference is not used as a label within 
this program. 


AS03046 through AS03050 are reserved for future use. 


AS03055 is the same as AS03052. 


AS03051 


AS03052 


AS03053 


AS03054 


DUPLICATE DEFINITION OF NAME 
ENTRY. +*...insert...* 

The name field entry definitions must be 
unique. All duplicates are discarded. 


ENTRY POINT DEFINITION IS NOT 
RELOCATABLE «.. .insert. . .* 

The entry point definition must resolve 
to a relocatable term. 


CSECT NAME IS ALREADY DEFINED, 
BUT NOT AS CSECT «.. .insert. . .* 
Control section names must not appear as 
ordinary name field entries. 


COM NAME IS ALREADY DEFINED, 
BUT NOT COM ~+«.. .insert.. .* 

COM names must not appear as ordinary 
name field entries. 


AS03056 through AS03058 are reserved for future use. 


LINE ERROR 
NUMBER TYPE 
nnnn F 
nnnn F 

NOTE: 

NOTE: 
nnnn F 
nnnn F 
nnann F 
nnnn F 

NOTE: 

NOTE: 
nnnn F 
nnnn F 
nnnn F 


AS03059 


AS03060 


AS03061 


DUPLICATE FORM DEFINITION. «.. .insert. .. 


The form definition name entry is previously 
defined. 


INVALID SYNTAX IN STORAGE 
RESERVATION. 

The operand of a reserve storage instruction 
must be preresolved, absolute, positive arithme- 
tic expression. Only one operand is allowed. 


INVALID SYNTAX IN DATA DEFINITION. 
The syntactical structure of the data definition 
operand is invalid. 


LINE 


NUMBER TYPE 


nnnan 


nann 


nnann 


nnnAn 


nnnn 


nnnn 


NOTE: 


nnann 


nannan 


nnnan 


nannan 


nanan 


ERROR 


CODE 


AS03062 


AS03063 


AS03064 


AS03065 


AS03066 


AS03067 


MESSAGE TEXT 


INVALID USE OF INDIRECTION. 
An indirect operator is invalid in data 
definition operands. 


INVALID USE OF LITERAL. 
The literal operator is invalid in size or 
repetition field of a data definition operand. 


INVALID SIZE SPECIFICATION. 
The size operand of data definitions must 
be preresolved absolute expression. 


INVALID REPETITION FACTOR. 

The repetition factor of a data definition 
operand must be a preresolved absolute 
expression. 


VAL UE OF LOCATION COUNTER 
EXCEEDS 65,535. 


TRUNCATION OCCURRED. 

The implied size of the value operand is 
greater than the explicit size operand ina 
data definition. 


AS03068 through ASO3069 are reserved for future use. 


F 


AS03070 


AS03071 


AS03072 


AS03073 


AS03074 


INVALID USE OF $SYSEG. 
The data following $SYSEG definition must 
be two bytes long, word aligned, and relocatable. 


REQUIRED OPERAND ENTRY MISSING. 
This instruction requires an operand and none 
was supplied. 


INVALID SUBLIST. 
The syntax indicates a suboperand, but the 
instruction does not allow suboperands. 


INVALID USE OF LITERAL. 
The instruction does not allow a literal as an 
operand, but one was coded. 


INVALID USE OF INDIRECTION. 
The instruction does not allow indirection, 
but indirection was coded. 


LINE ERROR ERROR 


NUMBER TYPE CODE MESSAGE TEXT 
nnnn F AS03075 INVALID EXPRESSION. 


The expression coded does not fall within the 
types allowed. 
A string type was used where only 
arithmetic type expressions are allowed. 
2. Anunresolved expression was coded on 
an instruction which required expressions 
to be predefined. 
3. A-relocatable expression is coded where 
only absolute are allowed. 


nnnn W AS03076 NAME FIELD OF ORG STATEMENT MAY 
ONLY CONTAIN A SEQUENCE SYMBOL. 


nonn W AS03077 INVALID RELOCATION. 
1. An absolute value was coded where a 
relocatable value was required. 
2. The relocation identifier does not 
match the relocation identifier for the 
control section in effect; e.g., trying to 
ORG to another CSECT or COM section. 


nnnn F AS03078 NAME ENTRY REQUIRED ON AN EQU 


STATEMENT. 
nann Ww AS03079 TOO MANY OPERANDS. 


More than the maximum number of operands 
allowable for this instruction were coded. The 
values of the first operands were used. 


nnnn F AS03080 ONLY SINGLE TERM RELOCATABLE 
EXPRESSIONS ARE VALID. 


nnnn F AS03081 COMBINED CSECT, COM AND EXTRN 
COUNT EXCEEDS 252. 
The binary generated will probably not be 
useless. Reduce the number of EXTERNs 
and CSECTs and COMs and reassemble. 


nnnn W AS03082 INVALID NAME ENTRY. 
The name entry was coded where none was 
allowed. The name entry has not been entered 
into the symbol table. Any reference to it will 
result in an undefined reference. 


nnnn F AS03083 REFERENCE TO INVALID FORM DEFINITION. 
1. The operation entry matches something other 
than a FORM definition. 
2. There was no such entry. 
3. No operand was coded on the reference. 


G-19 


LINE 


NUMBER 


nann 


nnnan 


nnann 


nnann 


nnann 


nnann 


nnan 


nann 


nann 


nnann 


nnnn 


nnann 


ERROR 


TYPE 


F 


ERROR 


CODE 


AS03084 


AS03085 


AS03086 


AS03087 


AS03088 


AS03089 


AS04001 


AS04002 


AS04003 


AS04004 


AS04005 


AS04006 


G-20 


MESSAGE TEXT 


OPERAND SIZE EXCEEDS 255 BITS. 

A FORM definition was coded with an operand 
which did not resolve to an absolute value less 
than 255. 


DUPLICATE DEFINITION OF NAME ENTRY. 


NAME ENTRY REQUIRED ON A FORM 
DEFINITION. 


CSECT NAME MAY NOT DUPLICATE COM 
NAME. 

The name entries of CSECT and COM state- 
ments cannot duplicate each other in the same 
assembly. 


ONLY ONE TITLE STATEMENT INA 
PROGRAM MAY HAVE A NONBLANK 
NAME FIELD. 


INVALID PRIME ENTRY POINT. 

1. |The operand of an END statement does 
not resolve to an even boundary. 

2. The operand does not reference a 
relocatable value. 


INVALID FORM DEFINITION. 
A form reference cannot be used as an operand 
entry. 


INVALID USE OF $SYSEG. 
$SYSEG is invalid in an evaluated expression. 


RELOCATABLE TERM INVALID WITH 
UNARY OPERATOR. 

A relocatable term may not be used in 
conjunction with a NOT operator. 


INVALID USE OF STRING CONSTANT. 
A string constant may not be used as a term 
in conjunction with an arithmetic or logical 
operator. 


RELOCATABLE TERM INVALID WITH */ 
OR LOGICAL OPERATOR ~«.. .insert. . .* 

A relocatable term may not be used in conjunc- 
tion with a multiplication, division, or logical 
operation. 


INVALID SYNTAX. 
The operand structure does not follow the rules 
of the language. 


INDEX 


Abort messages 
Absolute 


expressions, definition of 
terms, definition of 
Addressing in machine instructions 


ADO statement 
AGO statement 
ALIGN statement 
Alignment 

of data 


of machine instructions 
Alphabetical list of machine 


instructions 
ANOP statement 
Arithmetic 
constants 
operators 
set expressions 


Assembler instructions 


definition 

overview 

summary 
Assembly options 


BDD statement 

Begin-end columns 
alteration of 
description 

BRS statement 

Byte reserve storage 

Byte defined data 


Calling assembler 
Card codes 
Character 

codes 

set 

set expression 

string constants 


G-25 


2-17 
2-4 
3-2,3-3 
10-20 
10-23 
6-6 


8-2 
3-1 


C-1 


10-23 


2-7 
2-16 
10-16 


1-1 
4-1 
E-1 
11-1 


8-2 


Coding form 
format of 
statement continuation 
COM statement 
Comments 
Common control sections (see 


COM statement) 
Conditional assembly statements 


ADO 

AGO 

ANOP 

GBLA 

GBLC 

SETA 

SETC 
Constants 

arithmetic 

string 
Continuation of statements 
Control language for assembler 
Control sections 

and location counter 

assembler statements for 
Count attribute of macro instruc- 

tion operand 

Cross reference list, suppressing 
CSECT statement 


Data definition statements 
Diagnostic messages 


EBCDIC table 
EJECT statement 
END statement 
ENTRY statement 
EQU statement 
Error messages 
abort messages 
diagnostic messages 
system messages 


Index-1 


Expressions 
absolute 
definition 
evaluation of 
relocatable 
Extended mnemonics 
EXTRN statement 


FORM definition statement 

FORM instruction statement 

GBLA statement 

GBLC statement 

General purpose machine instruc- 
tions 

Global arithmetic and character 

set symbols 


Hex codes of machine instruc- 
tions 
Hexadecimal string constants 


ICTL statement 
Identification-sequence field 
Index registers 

Input format control 

Integer string constants 
ISEQ statement 


Job control language (see 
Control language) 


Linkage editor 
and control sections 
and symbol linkage 
map directive (SEG) 
Linking statements 
Listing control statements 
EJECT 
PRINT 
SPACE 
TITLE 
Literal pools 
and LTORG statement 
description 
Literals 
description 
in WDD and BDD statements 


5-1 
5-2 
7-1 
5-1,5-2 


9-2 
9-3 
9-2 
9-1 


6-4 
2-13 


2-13 
8-3 


Location counter 
and ALIGN statement 
and ORG statement 
and WDD and BDD statements 
description 
reference (asterisk) 
Logical operators 
LTORG statement 


Machine instructions 
alphabetical list 
definition 
hex code to mnemonic 
object formats 
summary 
Macro language 
concatenation of variable 
symbols 
count attribute 
example 
file definition 
general description 
macro definition 
macro instruction 
MEXIT statement 
MNOTE statement 
nesting of macros 
number attribute 
sublists in macro instructions 
sublists in model statements 
substring notation 
system variable symbols 
(&SYSNDX, &SYSECT) 
Messages, error 
Mnemonic definition (FORM) 


Name field, description 

Notation used to describe 
machine instructions 

Number attribute of macro 
instruction operand 


Object formats of machine instruc- 


tions 
Object program 
definition 
file definition 


Index-2 


6-6 
6-1 
8-4 
2-11 
2-11 
2-16 
6-4 . 


C-1 
1-1 
D-1 
B-1 
3-1 


10-11 
10-24 
F-1 
11-1 
10-1 
10-1 
10-5 
10-13 
10-12 
10-13 
10-25 
10-9 
10-9 
10-10 


10-13 
G-1 
8-7 
2-3 
3-2 


10-25 


B-1 


1-1 
11-1 


Operand field, description 

Operating system, relationship to 
assembler 

Operation codes (hex) for 
machine instructions 

Operation field, description 

Operators 

Ordinary symbols 

ORG statement 


Packed decimal string constants 
PRINT statement 
Program 
control statements 
listing 
sectioning 
termination 
PUNCH statement 


Registers 
Relational operators 
Relocatable 
expressions, definition of 
symbols, identification of 
terms, definition of 
Reserving storage 


SEG statement 
Segment names (see SYSEG) 
Sequence checking statements 
Sequence symbols 
Set symbols 
SETA statement 
SETC statement 
Source program 
definition 
file definition 
listing control 
Source statements 
basic format 
character set 
coding form 
expressions 


6-5 
2-11 
10-16 
10-16 
10-18 


1-1 
11-1 
9-1,11-2 


2-3 

2-1 

2-18 
2-3,2-14 


Source statements (continued) 

terms 
SPACE statement 
String constants 

character 

hexadecimal 

integer 

packed decimal 

zoned decimal 
Symbol definition statements 
Symbol length attribute 
Symbolic linkage statements 
Symbols 

definition 

ordinary 

rules for using 

sequence 

variable 
SYSEG reserved name 
System 

machine instructions 

messages 

requirements for assembler 
TITLE statement 
Termination of assembly 
Terms 

constants 

definition 

literals 

location counter reference 

symbols 

symbol length attribute 


Variable symbols 


WDD statement 
Word defined data 
Word reserve storage 
Writing to disk file 
WRS statement 


Zoned decimal string constants 
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